Connect Arxena to Cursor, Claude, and ChatGPT

Arxena exposes a remote Model Context Protocol (MCP) server so authorized AI clients can work your workspace—org charts, people, projects, and messaging—via a small meta-tool set (learn → execute) plus OpenAI search/fetch, using the same data you see in the app.

1. Create an API key

1. Sign in to Arxena Settings → Developers (workspace admin required).
2. Create an API key and copy the JWT token. You will paste this into your MCP client as X-API-KEY or Authorization: Bearer.
3. The MCP connector section on the API key detail page shows a ready-to-copy config with your token filled in.

2. Cursor (remote MCP)

Cursor supports url + headers directly. Open Settings → MCP → add a custom server:

{
  "mcpServers": {
    "arxena": {
      "url": "https://mcp.arxena.com/mcp",
      "headers": {
        "X-API-KEY": "<your-workspace-api-key-jwt>"
      }
    }
  }
}

3. Claude Desktop (remote MCP)

claude_desktop_config.json only launches stdio processes — it does not accept a url field. Use the mcp-remote bridge (same pattern as RapidAPI and other remote hubs). Add to mcpServers, then fully quit and reopen Claude Desktop (Cmd+Q):

{
  "mcpServers": {
    "arxena": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.arxena.com/mcp",
        "--header",
        "X-API-KEY: ${ARXENA_API_KEY}"
      ],
      "env": {
        "ARXENA_API_KEY": "<your-workspace-api-key-jwt>"
      }
    }
  }
}

Alternatively, use Settings → Connectors in Claude Desktop and add https://mcp.arxena.com/mcp for OAuth (see step 5).

4. Local MCP (stdio)

Run the stdio server on your machine instead of the hosted endpoint. Clone the Arxena repo, build packages/twenty-mcp-server, then point Claude Desktop at dist/index.js:

{
  "mcpServers": {
    "arxena": {
      "command": "node",
      "args": ["/path/to/arxena/packages/twenty-mcp-server/dist/index.js"],
      "env": {
        "ARXENA_API_TOKEN": "<your-workspace-api-key-jwt>",
        "ARXENA_BASE_URL": "https://app.arxena.com"
      }
    }
  }
}

5. Claude & ChatGPT app directories (OAuth)

Published directory integrations use OAuth 2.1 against https://mcp.arxena.com. Connect through the app store flow; at consent, paste your workspace API key JWT to authorize access to your data.

Claude callback URL: https://claude.ai/api/mcp/auth_callback

What you can do

• Search and fetch company org charts and leadership structure
• Query and update candidates, jobs, companies, and people
• Run LinkedIn search and enrichment workflows
• Draft and send outreach across connected channels
• Use OpenAI-compatible search and fetch tools for company knowledge

Reference

• Live docs: https://mcp.arxena.com/docs/mcp
• Privacy policy: MCP connector privacy
• Support: support@arxena.com

New to Arxena? Create a workspace first, then generate an API key from Developers settings.