DocsMCPMCP Setup

MCP

MCP Setup

Connect and configure the Model Context Protocol with Komuta.

This document describes how to connect Claude and Codex to the Komuta MCP server.

What can you do with the MCP?

Before installing, you can browse what the MCP server offers: provision services from a git repository, assess service health with Service Doctor, create managed Postgres / RabbitMQ / Valkey addons, inspect logs and traces, and look up packages and pricing.

Full list of tools and what they do: Komuta MCP Tools

Install for Claude

Claude Code (CLI)

claude mcp add --transport http komuta https://mcp.komuta.io/mcp -s user

Log in:

claude mcp login komuta

Adding the Komuta MCP server in the Claude Code terminal and logging in through the browser

Claude Desktop

  1. Go to Settings → Connectors → Add → Custom Connector.
  2. Fill in:
    • Name: Komuta
    • Remote MCP Server URL: https://mcp.komuta.io/mcp
  3. Click Add.
  4. Click Connect.

Install for Codex

  1. Install the Codex CLI:

    npm install -g @openai/codex
    
  2. Add this to ~/.codex/config.toml (on Windows: C:\Users\<Username>\.codex\config.toml):

    [mcp_servers.komuta]
    url = "https://mcp.komuta.io/mcp"
    scopes = ["openid", "email", "profile", "offline_access", "komuta:mcp"]
    
  3. Log in:

    codex mcp login komuta
    

Installing the Codex CLI in the terminal, adding the Komuta MCP server to config.toml and logging in

Verify the connection

Ask the agent to confirm the Komuta MCP server is connected, or to list its available tools. komuta should appear. Or type /mcp to check yourself (if it doesn't appear, try closing and reopening the app).

Troubleshooting

SymptomCause
Browser login doesn't open or completeRe-run codex mcp login komuta; for Claude Desktop, remove and re-add the connector.
Server not recognizedConfirm the configuration was added to the right file (~/.codex/config.toml) or via the correct CLI command.
401 Unauthorized / auth errorThe session may have expired; repeat the login step.