How to use Genecy MCP with ChatGPT, Claude, Grok, and other AI agents

In short: Genecy MCP lets AI assistants such as ChatGPT, Claude, Grok Bot, and Cursor use Genecy’s free banner tools for you. Create a key in your Genecy account, connect each agent the way that product actually supports, then ask it to validate or generate HTML5 banners.

MCP (Model Context Protocol) is a simple way for AI assistants to use trusted tools over the internet. Instead of copying files back and forth, you connect Genecy once, then ask the assistant to check or create Google Ad Manager–ready banners for you.

Genecy exposes a public MCP server at https://mcp.genecy.com/mcp. Your Genecy account owns the access keys. Each account can create several named keys, for example one for ChatGPT and another for Claude.

Each AI product connects differently. Use the guide for your agent below, and keep the vendor help page open if their menus change. Genecy’s two values stay the same: the server URL https://mcp.genecy.com/mcp, and a Bearer key from Settings → MCP keys.

What is MCP?

Think of MCP as a secure plug for AI tools.

  • You keep your Genecy account and keys in one place.
  • Your AI assistant connects with a key and can call Genecy tools.
  • You stay in the chat: ask for a check, a YouTube banner, or a hosted-video banner, and the assistant uses Genecy behind the scenes.

You do not need to know programming to use Genecy MCP. You need a Genecy key and a few minutes in the AI product’s connector, chat, or config screen.

MCP is not a Genecy login for people. It is a connection for AI agents. Your usual Genecy email and password still control the account in the browser.

What can Genecy MCP do?

Today Genecy MCP offers the same free banner helpers available on the Genecy website:

These tools are free to use through MCP with a valid account key. They help with creative QA and production; they do not replace Google Ad Manager approval.

Before you start

  1. Have a Genecy account. Sign in at Genecy if you are not already logged in.
  2. Decide which AI product you will connect first.
  3. Keep these values ready:
    • Server URL: https://mcp.genecy.com/mcp
    • Auth header value: Bearer YOUR_GENECY_KEY (include the word Bearer and a space before the key)

Only create keys for tools and people you trust. Treat each key like a password: anyone with the secret can call Genecy’s public MCP tools for that account.

Create a Genecy MCP key

  1. Sign in to Genecy and open Settings → MCP keys.
  2. Enter a clear key name, such as ChatGPT, Claude, Grok Bot, or Cursor.
  3. Choose Generate key.
  4. Copy the secret immediately. Genecy shows it once and does not store the full secret again.
  5. Store it somewhere private until you finish the agent’s own auth step (header field, secure secret card, or config file).

You can create several keys on the same account, disable a key if a tool should stop, or generate a new secret if an old one may have been shared.

Never publish an MCP key in a public chat, screenshot, GitHub repository, or shared document. If a key may have leaked, disable it or generate a new secret right away.

Connect ChatGPT

ChatGPT connects custom MCP servers as plugins on the web. Full custom MCP support is aimed at Business and Enterprise/Edu workspaces; Pro can connect with more limited permissions. OpenAI documents the current flow in Connecting custom MCP servers in ChatGPT and the developer guide Connect and test your plugin.

  1. Create a Genecy MCP key named something like ChatGPT.
  2. In ChatGPT on the web, go to Plugins.
  3. Select the plus button, then Add custom MCP server.
  4. Enter a name such as Genecy, and optionally a short description.
  5. Under Connection, enter the server URL https://mcp.genecy.com/mcp.
  6. Configure authentication for the server. Genecy expects Authorization: Bearer YOUR_KEY. ChatGPT’s plugin auth UI currently focuses on OAuth and “no authentication”; if your workspace offers an API key, bearer, or custom header option, paste Bearer YOUR_GENECY_KEY (or the key in the field that maps to that header). If only OAuth / no authentication are available, ChatGPT may not be able to call Genecy until that workspace supports a static Bearer credential.
  7. Review the risk warning, select I understand and want to continue, then Create as a plugin.
  8. Install the plugin, start a new chat, type @, select Genecy, and ask it to list tools or validate a banner.

ChatGPT needs a public HTTPS endpoint. A local Genecy install on your laptop is not reachable from ChatGPT. Workspace admins control who can create and publish custom MCP plugins.

Connect Claude

Claude adds Genecy as a custom connector by URL. The same connector works across claude.ai, Claude Desktop, Cowork, and mobile once it is on your account. Follow Anthropic’s guides: Get started with custom connectors using remote MCP and Add a connector that isn’t in the directory.

On Free, Pro, Max, or Ultra:

  1. Create a Genecy MCP key named Claude.
  2. Open Customize → Connectors (on the web: claude.ai/customize/connectors).
  3. Choose Add custom connector.
  4. Enter a name such as Genecy.
  5. Enter the MCP server URL https://mcp.genecy.com/mcp, then continue.
  6. Under Authentication, choose No sign-in (Genecy uses a fixed account key, not Claude OAuth).
  7. Under Request headers (when your account shows that section), add header name authorization with value Bearer YOUR_GENECY_KEY — include the word Bearer and the space. Mark it required, then add the connector.
  8. In a chat, open + → Connectors, turn Genecy on for that conversation, and ask Claude to validate a ZIP or build a YouTube banner.

On Team or Enterprise: an Owner (or a role that can manage connectors) adds the custom connector under Organization settings → Connectors first. Members then open Customize → Connectors and choose Connect.

Request headers for API keys are in beta for some Claude organizations. If you do not see Request headers, ask your admin or Anthropic support whether that option is enabled for your org. Claude connects to Genecy from Anthropic’s cloud, so the Genecy URL must stay publicly reachable.

Connect Grok Bot

Grok Bot does not use a settings form for custom MCP servers. You ask a Bot in chat to add the server; it confirms, registers the connector on your account, and can later turn a working flow into a reusable skill. Official references: Use the computer and apps, How Grok Bot works, and Skills and routines.

  1. Create a Genecy MCP key named Grok Bot.
  2. Open any Bot chat (your primary Bot is fine).
  3. Ask it to add Genecy as a custom MCP server. Say “custom MCP server” so it does not install a catalog plugin by mistake. Example: 
    Add a custom MCP server named Genecy at https://mcp.genecy.com/mcp.
It uses a Bearer API key in the Authorization header.
  4. When the Bot shows the name and URL, confirm / approve the add.
  5. When it asks for the key, enter the Genecy secret in the secure secret card (masked field). Do not paste the key into ordinary chat text. xAI’s docs say API keys go through that secure card.
  6. After the connector is ready, type @ in chat and attach Genecy (or ask the Bot to use Genecy), then try a banner task.
  7. Optional — save a skill: once a Genecy workflow works the way you want, ask: 
    Save the process we just used as a skill called “Genecy banner check.”
Include when to use Genecy MCP, that ZIP packages are preferred for validation,
and that customer publishing always needs my approval.
    Grok Bot stores that as a reusable skill across your Bots. Skills are instructions for how to do the task; the MCP connector is what actually calls Genecy.

Connected MCP servers are account-wide for your Bots. The Bot runs in the cloud, so localhost Genecy URLs do not work — use https://mcp.genecy.com/mcp.

Connect Cursor

Cursor loads remote MCP servers from an mcp.json file. Cursor documents this under Model Context Protocol (MCP) and MCP integrations.

  1. Create a Genecy MCP key named Cursor.
  2. Open Cursor Settings → Tools & MCP (or edit the JSON file directly).
  3. Add Genecy to your user config ~/.cursor/mcp.json (all projects) or project config .cursor/mcp.json:
{
  "mcpServers": {
    "genecy": {
      "url": "https://mcp.genecy.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GENECY_KEY"
      }
    }
  }
}
  1. Prefer "Authorization": "Bearer ${env:GENECY_MCP_KEY}" and keep the real key in an environment variable so you do not commit secrets.
  2. Save the file, return to Tools & MCP, and confirm Genecy appears and connects.
  3. In Agent chat, ask Cursor to use Genecy to validate a banner or generate a YouTube creative.

Connect other AI agents

Any Streamable HTTP MCP client can use Genecy with the same two values:

  • URL: https://mcp.genecy.com/mcp
  • Auth: Authorization: Bearer YOUR_GENECY_KEY

Create a separate Genecy key per agent so you can disable one connection without affecting the others. Follow that product’s own MCP or connector docs for where to paste the URL and header.

Example prompts you can try

After the connection works, plain language is enough:

  • “Use Genecy MCP to validate this HTML5 banner ZIP for Google Ad Manager.”
  • “Create a 300×250 YouTube banner for this video URL and give me the HTML file.”
  • “Build a 336×280 hosted video banner from this MP4 URL with muted autoplay.”
  • “Check this creative and share the Genecy report and preview links.”

Attach the ZIP or HTML when you ask for validation, and include the original file name when you can. That helps the validator return a clear uploadName and useful preview links.

Tips for smooth results

  • Prefer ZIP packages for real creatives that include images, fonts, or scripts next to the HTML.
  • Use HTTPS video URLs for hosted video banners.
  • One key per agent makes it easy to rotate or disable access later.
  • Use each product’s secure secret UI — never paste keys into ordinary chat when the agent offers a masked secret card or header field.
  • Validation is a static check — it does not run JavaScript in a browser and does not guarantee Google Ad Manager approval.
  • Keep secrets private — Genecy stores only a hash and a short hint, never the full key after you copy it.

FAQ

Do I need a paid Genecy plan for MCP?
The public MCP tools listed above are the free banner tools. You still need a Genecy account so you can create MCP keys under Settings.

Is Genecy MCP the same as logging into genecy.com?
No. The key authorizes the AI agent to call Genecy tools. It does not open your billing settings or replace member logins.

Can one account use several AI products?
Yes. Create multiple named keys — for example ChatGPT, Claude, Grok Bot, and Cursor — and manage them in Settings → MCP keys.

What if the agent says unauthorized?
Confirm you pasted the full secret (with Bearer when the product asks for the full header value), the key is still Enabled, and the server URL is exactly https://mcp.genecy.com/mcp.

Where can I try the same tools without an AI agent?
Use the website tools: HTML banner validator, YouTube embedded banner generator, and video banner generator.