Skip to content
Nyxory Docs

Connect your agent

MCP (Model Context Protocol) is the contract layer between your agent and Nyxory. Any MCP-speaking client can plug in. Pick yours below.

Wire your client

Section titled “Wire your client”

Edit ~/.claude/mcp.json (create the file if it doesn’t exist):

{
  "mcpServers": {
    "nyxory": {
      "url": "https://api.nyxory.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Restart Claude Code. Type /mcp in any chat to see Nyxory listed with its tools.

Getting a token

Section titled “Getting a token”

You have two paths. Pick based on where you’re running the agent.

Section titled “Interactive (recommended for your laptop)”
Terminal window
nyx login

Opens console.nyxory.com in your browser, you sign in, the CLI captures the token and writes it to its config. The Bearer above is then that token.

Headless (CI, shared workstations)

Section titled “Headless (CI, shared workstations)”

After one nyx login to bootstrap, create a named long-lived token:

Terminal window
nyx token create my-ci-runner
# → prints the plaintext ONCE — store it as a secret

Use the printed value as the Bearer. Rotate with nyx token delete <id> followed by another create.

Verify it’s wired

Section titled “Verify it’s wired”

Ask your agent to list MCP tools (in Claude Code: /mcp; in Cursor: tool palette). You should see at minimum:

  • nyx_deploy_start
  • nyx_help
  • nyx_app_list, nyx_app_get, nyx_app_deployments
  • nyx_project_*, nyx_account_*, nyx_domain_*

If they’re all there, you’re done. Next: try Quickstart.