MCP Server

Use Clavis directly in Claude Desktop as a native MCP server. Manage credentials and query services with natural language.

What is MCP?

The Model Context Protocol (MCP) is an open standard developed by Anthropic that allows AI assistants like Claude to securely connect to external tools and data sources. Instead of embedding credentials or writing custom API calls, you expose a set of tools that Claude can call on your behalf.

MCP servers run locally on your machine and communicate with Claude Desktop over a secure local socket. Your credentials never leave your computer — the MCP server talks to the Clavis API using your stored auth token.

Why use Clavis with Claude Desktop?

Clavis already manages your credentials for AI services like OpenAI, Anthropic, GitHub, Stripe, and more. The Clavis MCP server exposes that credential vault directly inside Claude Desktop — no copy-pasting API keys, no switching terminals.

• One place for all credentials — list, fetch, and check any service you have registered in Clavis, right from Claude.
• Natural language interface — ask Claude to "get my OpenAI credentials" or "check if my GitHub token is still valid" without writing code.
• Zero new attack surface — the MCP server reads from your existing Clavis account. Credentials stay encrypted; only valid tokens are returned.
• Works alongside the Python SDK — use the MCP server for interactive work in Claude Desktop, and the SDK for your production agent pipelines.

Installation

The Clavis MCP server is distributed as an npm package. Install it globally so Claude Desktop can find the binary:

$ npm install -g @clavisagent/mcp-server

Verify the installation:

$ clavis-mcp --version
0.1.1

Configuration

Add the Clavis MCP server to your Claude Desktop configuration file. The file location depends on your OS:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Add the following entry to the mcpServers section of your config. If the file does not exist yet, create it with the structure below:

{
  "mcpServers": {
    "clavis": {
      "command": "clavis-mcp",
      "args": [],
      "env": {
        "CLAVIS_API_KEY": "eyJ...",  // JWT from POST /v1/auth/login
        "CLAVIS_API_URL": "https://clavisagent.com"
      }
    }
  }
}

After saving the config, restart Claude Desktop. You should see a hammer icon in the chat input bar indicating MCP tools are available.

Available Tools

The Clavis MCP server exposes three tools to Claude:

Example: calling an API securely with call_service

Example Usage

Once the MCP server is running, you can interact with your Clavis credentials using plain English in Claude Desktop:

Troubleshooting

Claude Desktop does not show the Clavis tools

Make sure you have fully quit and restarted Claude Desktop after editing the config file. Also verify the config JSON is valid (no trailing commas). You can validate it with:

$ node -e "JSON.parse(require('fs').readFileSync(process.argv[1],'utf8')) && console.log('valid JSON')" \
  ~/Library/Application\ Support/Claude/claude_desktop_config.json

Authentication errors

If Claude reports authentication failures, your JWT may have expired (default TTL is 24 hours). Fetch a fresh token:

$ curl -sX POST https://clavisagent.com/v1/auth/login \
    -H 'Content-Type: application/json' \
    -d '{"email":"you@example.com","password":"yourpassword"}' \
  | python3 -m json.tool

Copy the new access_token value into your claude_desktop_config.json and restart Claude Desktop.

MCP server binary not found

Ensure clavis-mcp is on your PATH after the global install:

$ which clavis-mcp
/usr/local/bin/clavis-mcp

If the command is not found, check that your npm global bin directory is in your PATH. Run npm bin -g to find the path and add it to your shell profile.

NPM Package

The Clavis MCP server is published on npm. You can inspect the source, report issues, and track releases on the package page:

Next Steps