Docs/MCP Integration
DocsMCP Integration
Pro

MCP Integration

Connect GenMB to external AI clients via MCP server mode, or extend GenMB Code with external MCP tools — powered by the Model Context Protocol.

MCP features require the Pro plan or higher.

What is MCP

MCP (Model Context Protocol) is an open standard for AI tool integration. It defines how AI clients and servers communicate, allowing tools to be shared across different AI environments. GenMB supports MCP in both directions — as a server that exposes tools and as a client that consumes tools from external servers.

  • Open standard for connecting AI clients to tool providers.
  • Enables interoperability between AI platforms like Claude Code, Cursor, and GenMB.
  • Uses Streamable HTTP transport for real-time communication.

Pro Plan Required

All MCP features in GenMB require the Pro plan or higher. This includes both server mode (exposing tools to external clients) and client mode (connecting external servers to your apps).

Setting Up MCP Server Mode

GenMB exposes an MCP server that external AI clients can connect to. This lets you use tools like Claude Code or Cursor to manage your GenMB apps programmatically — create, update, deploy, and delete apps without leaving your AI client.

1

Create an API key

Go to your GenMB dashboard and create a new API key. The key uses the genmb_sk_ prefix and is shown only once at creation time — copy it immediately.
2

Configure your AI client

In your MCP-compatible client (Claude Code, Cursor, etc.), add a new MCP server connection. Set the server URL to the GenMB MCP endpoint and use your API key as the Bearer token for authentication.
3

Start using GenMB tools

Once connected, all 7 GenMB tools are available in your AI client. You can create apps, generate code, deploy to subdomains, and manage your projects — all through natural language within your client.

Best Way to Iterate

MCP server mode is the fastest way to manage multiple apps from Claude Code. You can create, update, and deploy apps in rapid succession without switching contexts — just describe what you want and the AI handles the rest.

Setting Up MCP Client Mode

Connect external MCP servers to your GenMB apps to extend GenMB Code with additional tools from third-party providers — database queries, API calls, code analysis, and more.

1

Open app settings

Navigate to your app in the editor and open the MCP Servers tab in the settings panel.
2

Add an MCP server

Enter the server URL and optional authentication credentials. The URL must use HTTPS and pass SSRF validation.
3

Test the connection

Use GenMB Code to verify the tools from the connected server are available. Try a simple tool call to confirm the connection works.
4

Use tools in GenMB Code

Tools from all connected MCP servers appear automatically in GenMB Code sessions. The AI can use them alongside built-in tools to assist with your app development.

Security Requirements

All MCP server URLs must use HTTPS — plain HTTP connections are rejected. URLs are validated against SSRF protections to block private IP ranges and internal network addresses. This ensures external servers cannot be used to probe your infrastructure.
Each app supports up to 10 connected MCP servers. Auth tokens for external servers are Fernet-encrypted at rest and only decrypted at the point of outbound calls.

Available Tools

The GenMB MCP server exposes 7 tools for managing apps programmatically from any MCP-compatible client. Each tool maps to a core GenMB operation.

create_app

Create a new app from a natural language prompt.

update_app

Refine an existing app with a follow-up prompt.

list_apps

List all apps belonging to the authenticated user.

get_app

Get details and code for a specific app by ID.

deploy_app

Deploy an app to a *.genmb.com subdomain.

delete_app

Permanently delete an app.

generate_code

Generate code from a prompt without creating a persistent app.

Using Tools Effectively

Use generate_code for quick experiments without creating a persistent app. Use create_app when you want to save, iterate on, and deploy the result.

API Key Management

API keys authenticate MCP requests. They are created in the GenMB dashboard and used as Bearer tokens by external clients.

  • Create up to 5 API keys per user account.
  • Keys use the genmb_sk_ prefix for easy identification.
  • Keys are SHA-256 hashed before storage in Firestore — the raw key is shown only once at creation time.
  • Revoke any key instantly from the dashboard. Revocation takes effect immediately.
  • Each key grants full access to the authenticated user's apps and operations.
Store your API key securely. If you suspect a key is compromised, revoke it immediately from the dashboard and create a new one. The raw key is displayed only once at creation — it cannot be retrieved later.

Security

MCP integration includes multiple security layers to protect your account and prevent abuse.

SSRF protection

All MCP server URLs are validated to block private IP ranges and non-HTTPS schemes.

HTTPS-only

MCP server connections must use HTTPS. Plain HTTP is rejected.

Rate limiting

60 requests per minute per user, enforced in-memory with periodic cleanup.

Result truncation

MCP tool results are truncated at 50,000 characters to prevent memory issues.

Encrypted tokens

Auth tokens for external servers are Fernet-encrypted at rest and only decrypted at the point of outbound calls.

Rate limit headers are included in MCP responses. If you are scripting bulk operations, check these headers to avoid hitting the 60 requests/minute limit.

FAQs

What AI clients can connect to GenMB's MCP server?
Any AI client that supports the Model Context Protocol with Streamable HTTP transport can connect. This includes Claude Code, Cursor, and other MCP-compatible tools. You authenticate with a GenMB API key passed as a Bearer token.
Is MCP available on the Free plan?
No. Both MCP server mode (exposing GenMB tools) and MCP client mode (connecting external servers) require the Pro plan or higher.
How do I connect Claude Code to GenMB?
Create an API key in your GenMB dashboard, then configure Claude Code to use the GenMB MCP server URL with your API key as the Bearer token. Once connected, you can create, edit, deploy, and manage GenMB apps directly from Claude Code.
Can I connect multiple external MCP servers to one app?
Yes. Each app can connect up to 10 external MCP servers. Tools from all connected servers are available in GenMB Code sessions simultaneously.
What happens if my API key is compromised?
Revoke the key immediately from your GenMB dashboard. Revocation takes effect instantly — all requests using that key will be rejected. Then create a new key and update your client configuration.

Ready to build?

Create your first app for free — no credit card required.