Skip to main content

​
Usage

codaph mcp setup claude [options]
Configures Claude Code (claude.ai/code) to use the Codaph MCP server by generating and optionally installing the MCP configuration.

​
Options

​
--scope
string
default:"user"
Configuration scope: user or project.
  • user: Installs globally for all Claude Code sessions
  • project: Creates project-specific configuration in .codaph/mcp/
​
--run
boolean
default:"false"
Automatically apply the configuration to Claude Code settings.Without this flag, the command only generates the template.
​
--cwd
string
Working directory path. Defaults to current directory.
​
--json
boolean
default:"false"
Output results in JSON format.

​
Examples

​
Generate MCP configuration template

codaph mcp setup claude
This creates .codaph/mcp/claude-code.json with the MCP server configuration.

​
Install for user (all projects)

codaph mcp setup claude --scope user --run
Installs Codaph MCP server globally for Claude Code.

​
Install for project only

codaph mcp setup claude --scope project --run
Creates project-specific MCP configuration.

​
Generated Configuration

The command generates a Claude Code MCP configuration: 
{
  "mcpServers": {
    "codaph": {
      "type": "stdio",
      "command": "codaph",
      "args": ["mcp"]
    }
  }
}

​
Configuration Locations

​
User Scope

The configuration is added to Claude Code’s global settings:
  • macOS/Linux: ~/.config/claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

​
Project Scope

The configuration is saved in the project:
  • .codaph/mcp/claude-code.json
You must manually merge this into your Claude Code settings or use a project-specific config loading mechanism.

​
Manual Installation

If you prefer to install manually:
  1. Generate the template: 
    codaph mcp setup claude
  2. Copy the configuration from .codaph/mcp/claude-code.json
  3. Add it to your Claude Code settings file
  4. Restart Claude Code

​
Verification

After setup, Claude Code should show the Codaph MCP server in its available tools. You can verify by:
  1. Opening Claude Code
  2. Starting a new conversation
  3. Typing “List available tools” - you should see codaph_* tools

​
Troubleshooting

​
MCP server not connecting

  1. Verify codaph is in your PATH: 
    which codaph
  2. Test MCP server manually: 
    echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | codaph mcp
  3. Check Claude Code logs for connection errors

​
Tools not appearing

  1. Restart Claude Code after configuration changes
  2. Verify JSON syntax in config file
  3. Check that mcpServers section is properly formatted

Build docs developers (and LLMs) love

Get started for freeTalk to us