Account creation

Create your GridMCP account.

This sends you to Stripe for the credit-card step. After Stripe confirms the trial, we email your one-time setup link.

Organization nameYour nameEmail for setup linkPlanBilling intervalWhich AI clients will you connect?Selecting clients personalizes your setup instructions and email — it does not lock the account to those clients; you can add or remove client keys anytime after setup.Standard includes 5 active client-key slots; Pro includes 10. Choose one slot per client installation you want to revoke or rotate independently.GridMCP does not yet support hosted Claude.ai/Claude Desktop or ChatGPT connectors — both require an OAuth connector flow GridMCP has not implemented or tested. Use one of the supported native clients below or a generic remote Streamable HTTP MCP client.

Selected client setup instructions

These exact instructions are also included in your setup email. The placeholder is replaced with each one-time key when you claim the account.

Claude Code setup instructions

Official client documentation

Claude Code — Streamable HTTP is the recommended transport for remote MCP servers.
claude mcp add --transport http gridmcp https://mcp.gridmcp.ai/mcp --header "Authorization: Bearer YOUR_GRIDMCP_API_KEY"
Or add this entry to .mcp.json (project) or ~/.claude.json (user):
{
  "mcpServers": {
    "gridmcp": {
      "type": "http",
      "url": "https://mcp.gridmcp.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GRIDMCP_API_KEY"
      }
    }
  }
}
Then restart/reconnect the client and call the list_projects tool to verify it returns only your assigned projects.

Cursor setup instructions

Official client documentation

Cursor — remote Streamable HTTP MCP server.
Add this entry to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
  "mcpServers": {
    "gridmcp": {
      "url": "https://mcp.gridmcp.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GRIDMCP_API_KEY"
      }
    }
  }
}
Reload MCP servers from Cursor Settings > MCP after saving.
Then restart/reconnect the client and call the list_projects tool to verify it returns only your assigned projects.

VS Code setup instructions

Official client documentation

VS Code — native MCP support, Streamable HTTP ("type": "http").
Add this entry to .vscode/mcp.json in your workspace:
{
  "servers": {
    "gridmcp": {
      "type": "http",
      "url": "https://mcp.gridmcp.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GRIDMCP_API_KEY"
      }
    }
  }
}
Reload the window after saving.
Then restart/reconnect the client and call the list_projects tool to verify it returns only your assigned projects.

Gemini CLI setup instructions

Official client documentation

Gemini CLI — remote Streamable HTTP MCP server.
gemini mcp add --transport http --header "Authorization: Bearer YOUR_GRIDMCP_API_KEY" gridmcp https://mcp.gridmcp.ai/mcp
Or add this entry to ~/.gemini/settings.json (or .gemini/settings.json):
{
  "mcpServers": {
    "gridmcp": {
      "httpUrl": "https://mcp.gridmcp.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GRIDMCP_API_KEY"
      }
    }
  }
}
Restart the Gemini CLI session after saving.
Then restart/reconnect the client and call the list_projects tool to verify it returns only your assigned projects.

OpenAI Codex CLI setup instructions

Official client documentation

OpenAI Codex CLI — remote Streamable HTTP MCP server.
codex mcp add gridmcp --url https://mcp.gridmcp.ai/mcp --bearer-token-env-var GRIDMCP_API_KEY
Set the GRIDMCP_API_KEY environment variable to YOUR_GRIDMCP_API_KEY, or add this to ~/.codex/config.toml:
[mcp_servers.gridmcp]
url = "https://mcp.gridmcp.ai/mcp"
bearer_token_env_var = "GRIDMCP_API_KEY"
Restart Codex after saving.
Then restart/reconnect the client and call the list_projects tool to verify it returns only your assigned projects.

Hermes Agent setup instructions

Official client documentation

Hermes Agent — remote Streamable HTTP MCP server.
MCP server URL: https://mcp.gridmcp.ai/mcp
Authorization header: Bearer YOUR_GRIDMCP_API_KEY
Add GridMCP through your Hermes Agent's remote MCP server configuration.
Then restart/reconnect the client and call the list_projects tool to verify it returns only your assigned projects.

Generic remote MCP client setup instructions

Generic remote MCP client — Streamable HTTP.
MCP server URL: https://mcp.gridmcp.ai/mcp
Authorization header: Bearer YOUR_GRIDMCP_API_KEY
Developer REST API — not an MCP transport: https://app.gridmcp.ai/api/v1/mcp
Consult your client's documentation for adding a remote Streamable HTTP MCP server.
Then restart/reconnect the client and call the list_projects tool to verify it returns only your assigned projects.