Connect Arxena to Cursor, Claude, and ChatGPT

Arxena exposes a remote Model Context Protocol (MCP) server so authorized AI clients can read and act on your recruitment workspace—org charts, candidates, jobs, and messaging—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.