Skip to main content

​
Prerequisites

You need one of these AI coding tools installed:

​
Get your API key

1

Request an API key

Ask your team lead or contact support@colismove.com to get a ColisMove MCP API key.
2

Keep it safe

Your API key looks like this: deb732d...a3d40. Treat it like a password — don’t commit it to git.

​
Setup

​
Option 1: CLI command (fastest)

claude mcp add colismove-mcp \
  --transport http \
  --url https://colismove-mcp.onrender.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

​
Option 2: Config file

Create .mcp.json at your project root:
{
  "mcpServers": {
    "colismove-mcp": {
      "type": "http",
      "url": "https://colismove-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

​
Option 3: Global (all projects)

Create ~/.claude/.mcp.json:
{
  "mcpServers": {
    "colismove-mcp": {
      "type": "http",
      "url": "https://colismove-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Use the global option if you want ColisMove context available from any project directory.
To avoid hardcoding your API key, use an environment variable: 
{
  "mcpServers": {
    "colismove-mcp": {
      "type": "http",
      "url": "https://colismove-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer ${COLISMOVE_MCP_KEY}"
      }
    }
  }
}
Then set the variable in your shell profile (~/.zshrc or ~/.bashrc): 
export COLISMOVE_MCP_KEY="your-api-key-here"

​
Verify the connection

After setup, restart your AI tool and check:
Type /mcp in Claude Code. You should see colismove-mcp with a green status.Then try:
What endpoints exist for bookings?

​
Troubleshooting

  • Check that the URL is exactly https://colismove-mcp.onrender.com/mcp (no trailing slash)
  • Verify your API key is correct
  • The server may take ~30 seconds to wake up on first request (free Render tier)
  • Restart your AI tool after adding the configuration
  • In Claude Code, run /mcp to check server status
  • Ensure the .mcp.json file is in the project root or ~/.claude/
  • Double-check your API key — it should be the full key, not truncated
  • Make sure the header format is Bearer YOUR_KEY (with a space after Bearer)
  • Contact your team lead if the key has been rotated
The MCP server runs on Render’s free tier. The first request after inactivity may take 30-60 seconds while the server wakes up. Subsequent requests are fast.