Setting Up Converra

1. Connect with native OAuth

Codex

codex mcp add converra --url https://converra.ai/api/mcp
codex mcp login converra

Sign in to Converra and confirm the exact tenant shown during consent. Interactive access tokens expire after one hour. Compatible clients rotate refresh tokens within a 30-day grant. Re-run codex mcp login converra if the grant expires, is revoked, or the client asks you to authenticate again.

Claude Code

claude mcp add --transport http converra https://converra.ai/api/mcp

Open /mcp inside Claude Code and complete the browser OAuth flow.

Converra rotates public-client refresh tokens. Reuse of a consumed refresh token revokes the active token family and requires a fresh browser login.

Clients registered before refresh support must register again to receive a refresh token. Confirm the exact tenant whenever a new browser login appears.

2. Start using it

Upload your prompt and conversations:

"Here's my prompt: [paste your prompt]. I'm using GPT-4o."

"Here are some real conversations from my AI agent: [paste transcripts]"

Analyze your prompt:

"Analyze my prompt and tell me what's working and what could be improved"

Optimize it:

"Optimize my prompt and show me the results"

---

API-key setup for machine-to-machine integrations

For unattended services or clients without native OAuth, create a least-privilege API key in Converra account settings and keep it in a secret manager. Do not paste keys into chat prompts.

Cursor

Create .cursor/mcp.json:

{
  "mcpServers": {
    "converra": {
      "url": "https://converra.ai/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop

Add to your config file:

{
  "mcpServers": {
    "converra": {
      "url": "https://converra.ai/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Config locations:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Windsurf

{
  "mcpServers": {
    "converra": {
      "serverType": "sse",
      "url": "https://converra.ai/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Code

claude mcp add --transport http converra https://converra.ai/api/mcp

Authenticate from /mcp in Claude Code. Use the API-key configurations above only for a client or service that cannot complete OAuth.

AntiGravity (Gemini)

Edit ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "converra": {
      "url": "https://converra.ai/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}