Install guide

Connect Plumail to Claude Code

Plumail exposes a hosted MCP server. Nothing to install, nothing to run: one command, and the session knows your workspace.

Create an API key
In your Plumail workspace: Settings → API → New key. Name it, tick the permissions, save. The key is shown ONCE — copy it immediately. It starts with plm_live_ followed by thirty-two characters.
02
Add the MCP server
In your terminal, replacing YOUR_KEY with the key you copied in the previous step. Add --scope user for the connection to apply across all your projects, not just the current folder.
```
claude mcp add plumail \
  --transport http \
  --url https://plumail.fr/api/mcp \
  --header "Authorization: Bearer YOUR_KEY"
```
03
Check that Claude Code sees it
The command lists connected servers and their status. "plumail" should appear as connected.
```
claude mcp list
```
04
Check that it's connected
Ask for the account status. This is read-only: nothing is modified, nothing is sent. The response names your workspace and lists your verified sending domains — those are the addresses you can send from.
```
In the session: "What Plumail workspace do you see, and which sending domains are verified?"
```

Troubleshooting

Every API error carries a readable code. Here are the ones you encounter when connecting.

"plumail" shows as "failed" in claude mcp list	The Authorization header is malformed. It must contain the word Bearer, a space, then the key: "Authorization: Bearer plm_live_…". The quotes around the value are required.
401 invalid_api_key	The key is incomplete (a newline crept in during copy-paste) or has been replaced. Create a new one.
401 revoked_api_key	The key was cut under Settings → API. Create another one.
403 insufficient_scope	The key does not have the required permission. Permissions are chosen at creation and cannot be changed: create a key with the right scope.
422 unverified_from_domain	The sending address is not on a verified domain in the workspace. The error message lists the ones that are. To add one: Domains → Add a domain, then set the DNS records.
429 rate_limit_exceeded	More than 600 requests per minute for this key. The Retry-After header says how many seconds to wait.