Skip to main content

​
Prerequisites

Before starting with Claude Code CLI, ensure you have Node.js and npm installed:
If not installed, download from nodejs.org. Install Claude Code CLI globally using npm:
After installation, verify the claude command is available:

​
Setup

1

Add the Danube MCP Server

Use the Claude Code CLI command to add Danube as a remote HTTP server:
2

Verify Connection

Launch Claude Code CLI and use the /mcp command to verify the connection:
Then in Claude Code CLI, type:
You should see the danube server listed and connected.

​
Team Rollout (Project Scope)

For teams, don’t configure each seat by hand — commit a project-scoped .mcp.json to your repository. Claude Code picks it up automatically for everyone who works in the repo.
1

Generate the template

Fetch a ready-to-commit .mcp.json for your organization:
The mcp_json field is the file content. It pins your organization via the danube-org-id header and uses an environment-variable placeholder for the key, so no secrets land in the repo:
2

Commit it

Save it as .mcp.json at the repo root and commit. Alternatively, use the CLI:
Use --scope user instead to configure a single seat across all of that user’s projects.
3

Each engineer sets their key

Every engineer sets DANUBE_API_KEY in their environment (obtained from the dashboard or via device-code enrollment). Claude Code expands ${DANUBE_API_KEY} at connect time, and each seat’s access is governed by their role in the organization.
You can also distribute your organization’s governed agent skill:

​
Troubleshooting

If you see “Unknown command: claude” or “command not found”:
  1. Verify installation:
  2. Check npm global bin directory:
    The claude command should be in {prefix}/bin/
  3. Add to PATH (if needed): On macOS/Linux, add to ~/.zshrc, ~/.bashrc, or ~/.config/fish/config.fish:
    Then restart your terminal or run source ~/.zshrc
  4. Reinstall if needed:
  • Verify the config file path is correct
  • Check JSON syntax (no trailing commas)
  • Restart the CLI
  • Verify your API key is correct
  • Ensure the header is danube-api-key (lowercase)
  • Check that the API key hasn’t expired or been revoked
For the best experience with Claude Code CLI and Danube, we recommend adding the Agent Skill. The Agent Skill teaches Claude how to effectively discover and use tools through the Danube MCP Server, providing better tool discovery patterns, authentication handling, and workflow guidance.

Learn About the Agent Skill

See installation instructions and learn how the skill enhances Claude’s ability to use Danube