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
-
Add the server in your terminal:
claude mcp add --transport http xentropy https://api.xentropy.ai/mcp -
Start Claude Code and run
/mcp. -
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@xentropyThen 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 loginneeds one. Over SSH, usessh -t, or sign in from/mcpinside 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.