Claude Code Integration Guide

Connect Claude Code to the Monta Partner API MCP server to query and manage your charging infrastructure directly from the terminal.

Prerequisites

Claude Code installed (npm install -g @anthropic-ai/claude-code)
Monta Partner API credentials (Client ID and Client Secret) — create these in Monta Hub, see Access and set up API keys in Monta Hub

Quick Setup

Add the hosted MCP server with a single command:

claude mcp add --transport http monta-partner-api https://partner-api-mcp.monta.app/mcp \
  --header "X-Monta-Auth: YOUR_CLIENT_ID:YOUR_CLIENT_SECRET"

Replace YOUR_CLIENT_ID and YOUR_CLIENT_SECRET with your actual credentials.

Verify the connection:

claude mcp list

You should see monta-partner-api listed as connected. Then start Claude Code and try:

List my Monta teams

Authentication Options

The server accepts any of these header formats — pass whichever fits your setup via --header:

Method	Header
Combined (simplest)	`X-Monta-Auth: clientId:clientSecret`
Separate headers	`X-Monta-Client-Id: clientId` and `X-Monta-Client-Secret: clientSecret`
Bearer token	`Authorization: Bearer YOUR_ACCESS_TOKEN`

For separate headers, pass --header twice:

claude mcp add --transport http monta-partner-api https://partner-api-mcp.monta.app/mcp \
  --header "X-Monta-Client-Id: YOUR_CLIENT_ID" \
  --header "X-Monta-Client-Secret: YOUR_CLIENT_SECRET"

Scopes

By default claude mcp add registers the server for the current project only. To make it available everywhere, add --scope user:

claude mcp add --transport http --scope user monta-partner-api https://partner-api-mcp.monta.app/mcp \
  --header "X-Monta-Auth: YOUR_CLIENT_ID:YOUR_CLIENT_SECRET"

To share the configuration with your team via a checked-in .mcp.json file (without committing credentials), use --scope project with an environment variable:

claude mcp add --transport http --scope project monta-partner-api https://partner-api-mcp.monta.app/mcp \
  --header "X-Monta-Auth: ${MONTA_CLIENT_ID}:${MONTA_CLIENT_SECRET}"

Claude Code expands environment variables in .mcp.json at startup, so each teammate sets MONTA_CLIENT_ID / MONTA_CLIENT_SECRET in their own shell.

Example Prompts

Show me all charge points and their current state
What's the status of charge point 12345?
Start a charging session at charge point 12345
Show me charging sessions from the last 24 hours
Restart all offline charge points in team 42

Troubleshooting

Server shows as failed in claude mcp list — check the header value: it must contain your real credentials, not placeholders. Re-add the server after fixing (claude mcp remove monta-partner-api first).
401 Unauthorized — credentials are wrong or revoked. Create a new API key in Monta Hub.
Tools missing (e.g. no delete operations) — the available tools depend on your credential scopes. Full all scope exposes every endpoint; all:read + all:write hides delete operations.

Getting Help

API Documentation: Monta Partner API Docs
Claude Code MCP docs: docs.anthropic.com/en/docs/claude-code/mcp
Support: Contact Monta support for API issues