Connect Claude Code
Claude Code connects to the anymail MCP server over HTTP. Sign in with OAuth in the browser, or send an API token as a header for a machine without a browser.
With OAuth#
- Add the server:
bash
claude mcp add --transport http anymail https://app.anymail.watch/api/mcp
- Start Claude Code and run
/mcp. - Select
anymail, then Authenticate. A browser window opens anymail. - Sign in, pick the Workspace and the Access, and select Allow.
Claude Code stores the tokens and refreshes them. To sign in from the shell without opening a session, run claude mcp login anymail. To sign out, use Clear authentication in the /mcp menu.
With an API token#
Generate a token in Settings, Integrations, API keys. See Authentication. A read only token is enough for reports.
claude mcp add --transport http anymail https://app.anymail.watch/api/mcp \
--header "Authorization: Bearer $ANYMAIL_TOKEN"
With a header, Claude Code does not use OAuth. When the token is revoked, the connection fails until you add the server again with a new token.
Scope of the configuration#
claude mcp add saves the server for you, in the current project, by default. Add --scope user to use anymail in every project, or --scope project to share the server through .mcp.json with your team. Do not put a token in a shared .mcp.json. Use OAuth there, so that each person signs in.
claude mcp add --transport http anymail https://app.anymail.watch/api/mcp --scope user
Check the connection#
Run /mcp in Claude Code. It lists anymail as connected, with 44 tools. Then ask, for example: "List my anymail campaigns with their reply rate."
The prompts of the server are commands in Claude Code:
/mcp__anymail__campaign_report
/mcp__anymail__review_replies
/mcp__anymail__build_campaign