Claude Code Integration

Claude Code supports MCP servers via the claude mcp add command. This is the fastest way to add mpak bundles.

Quick Setup

Add any mpak bundle with a single command:

claude mcp add --transport stdio echo -- mpak run @nimblebraininc/echo

That’s it. The server is now available in Claude Code.

How It Works

claude mcp add registers the MCP server with Claude Code
--transport stdio tells Claude Code this is a local process
mpak run downloads, caches, and executes the bundle

Servers Requiring Configuration

For bundles that need API keys or other configuration:

claude mcp add --transport stdio ipinfo \
  --env IPINFO_API_TOKEN=your-token-here \
  -- mpak run @nimblebraininc/ipinfo

You can pass multiple --env flags:

claude mcp add --transport stdio myserver \
  --env API_KEY=xxx \
  --env DEBUG=true \
  -- mpak run @owner/myserver

Configuration Scopes

Claude Code supports different scopes for MCP server configuration:

# Local (default) - stored in ~/.claude.json, not shared
claude mcp add --transport stdio echo -- mpak run @nimblebraininc/echo

# Project - stored in .mcp.json, checked into git
claude mcp add --transport stdio --scope project echo -- mpak run @nimblebraininc/echo

# User - stored in ~/.claude.json globally
claude mcp add --transport stdio --scope user echo -- mpak run @nimblebraininc/echo

Pin to a Specific Version

claude mcp add --transport stdio echo -- mpak run @nimblebraininc/echo@1.0.0

Managing Servers

# List all configured servers
claude mcp list

# Get details for a server
claude mcp get echo

# Remove a server
claude mcp remove echo

# Check server status (within Claude Code)
/mcp

Alternative: Use mpak config

Instead of passing --env flags, you can store configuration with mpak:

# Store config once
mpak config set @nimblebraininc/ipinfo api_key=your-token

# Then add without env flags
claude mcp add --transport stdio ipinfo -- mpak run @nimblebraininc/ipinfo

mpak resolves stored config automatically when running.

Troubleshooting

Server Not Starting

Test the bundle runs directly:
Terminal window
```
mpak run @nimblebraininc/echo
```
Check Claude Code’s MCP status:
```
/mcp
```

Command Not Found

Ensure mpak is installed globally:

npm install -g @nimblebrain/mpak
which mpak  # Should show the path

View Server Output

Run the bundle directly to see any error output:

mpak run @nimblebraininc/echo