> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xentfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop & Claude Code

> Connect XentFi agent tools to Claude Desktop and Claude Code via MCP.

Both Claude Desktop and Claude Code read the same `mcpServers` config shape.

## Claude Desktop

<Steps>
  <Step title="Open the config file">
    **Settings → Developer → Edit Config**, or edit it directly:

    * macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
    * Windows: `%APPDATA%\Claude\claude_desktop_config.json`
    * Linux: `~/.config/Claude/claude_desktop_config.json`
  </Step>

  <Step title="Add the XentFi server">
    ```json theme={null}
    {
        "mcpServers": {
            "xentfi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@xentfi/mcp-server"
                ],
                "env": {
                    "XENTFI_AGENT_KEY": "sk_agent_xxx",
                }
            }
        }
    }
    ```
  </Step>

  <Step title="Restart Claude Desktop">
    Fully quit and reopen the app. Open a new chat, click the tools/plug icon, and confirm `xentfi` appears with its 15 tools.
  </Step>

  <Step title="Try it">
    Ask: *"Check my XentFi agent info and list my wallets."*
  </Step>
</Steps>

### Global install alternative

If you'd rather not have `npx` re-resolve the package every launch:

```bash theme={null}
npm install -g @xentfi/mcp-server
```

```json theme={null}
{
    "mcpServers": {
        "xentfi": {
            "command": "xentfi-mcp",
            "env": {
                "XENTFI_AGENT_KEY": "sk_agent_xxx"
            }
        }
    }
}
```

## Claude Code

```bash theme={null}
claude mcp add xentfi -- npx -y @xentfi/mcp-server
```

Set `XENTFI_AGENT_KEY` as an environment variable in the shell Claude Code runs in, or add it to the generated config entry's `"env"` block the same way as above. Verify with:

```bash theme={null}
claude mcp list
```

You should see `xentfi` listed as connected.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Server doesn't appear">
    Check Claude Desktop's MCP logs (Settings → Developer → Open Logs Folder) for `[xentfi-mcp]` startup lines or a `Missing XENTFI_AGENT_KEY` error.
  </Accordion>

  <Accordion title="&#x22;Missing XentFi agent API key&#x22; tool errors">
    The env var didn't reach the subprocess — check the `env` block is inside the `xentfi` server entry, not at the top level of the config file.
  </Accordion>

  <Accordion title="npx is slow on every launch">
    Switch to the global-install form above, or pin a version: `"args": ["-y", "@xentfi/mcp-server@1.0.0"]`.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Tools Reference" icon="list" href="/agent/tools-reference">
    See every available tool.
  </Card>

  <Card title="Other clients" icon="puzzle" href="/agent/cursor">
    Cursor, VS Code, ChatGPT, ElizaOS, CrewAI, Codex.
  </Card>
</CardGroup>