Docs
Agents and APIClients

Claude Code

Add Xentropy to Claude Code as a remote HTTP MCP server and sign in with OAuth or an API key.

Claude Code connects to Xentropy as a remote HTTP MCP server.

Connect with OAuth

  1. Add the server in your terminal:

    claude mcp add --transport http xentropy https://api.xentropy.ai/mcp
  2. Start Claude Code and run /mcp.

  3. Select xentropy, choose Authenticate, then sign in to Xentropy and review the requested access. You can also run claude mcp login xentropy.

Claude Code signs in through a loopback address on your machine, so no API key or client secret is needed.

Plugin

The Xentropy plugin for Claude Code adds the MCP server and Xentropy skills. Install it with:

claude plugin marketplace add xentropyai/xentropy-plugins
claude plugin install xentropy@xentropy

Then sign in: run /mcp, choose plugin:xentropy:xentropy and Authenticate, or run claude mcp login plugin:xentropy:xentropy. The plugin names its server plugin:xentropy:xentropy, so claude mcp login xentropy does not find it.

Headless use with an API key

For CI or scripts without a browser, create a key with the Agent preset under Settings → API Keys and keep it in your environment as XENTROPY_API_KEY. Add the server to the project's .mcp.json with a header that reads the variable:

{
  "mcpServers": {
    "xentropy": {
      "type": "http",
      "url": "https://api.xentropy.ai/mcp",
      "headers": { "Authorization": "Bearer ${XENTROPY_API_KEY}" }
    }
  }
}

Claude Code expands ${XENTROPY_API_KEY} from the environment, so the file never holds the key. Never paste a real key into a prompt, a project file or a shared document.

Scopes to grant

OAuth sign-in offers the agent default scopes: artifacts:read, artifacts:write, artifacts:render, dashboards:read, dashboards:write, data:read, data:write and connections:read. The Agent preset for API keys matches that set. See API keys and scopes.

Troubleshooting

  • Not an interactive terminal. claude mcp login needs one. Over SSH, use ssh -t, or sign in from /mcp inside Claude Code.
  • New tools are missing. Claude Code caches the tool list for a session. After a Xentropy update, restart Claude Code or reconnect in /mcp.
  • Authentication needed again. Run /mcp, select xentropy and choose Authenticate.
  • Revoked or expired. OAuth connections appear in Agent access → Connected assistants; API keys under Settings → API Keys.

On this page