# Claude Code

Source: https://docs.simail.ai/zh/mcp/claude-code/

> 在 Claude Code 里添加 simail MCP 服务，API key 取自环境变量。

在控制台建一把单邮箱 key，并在启动 Claude Code 的 shell 里导出：

```sh
export SIMAIL_API_KEY="sk_…"
```

## 命令行

```sh
claude mcp add --transport http simail https://api.simail.ai/mcp \
  --header "Authorization: Bearer ${SIMAIL_API_KEY}"
```

加 `--scope user` 可在所有项目中使用，加 `--scope project` 会写入 `.mcp.json`。注意：命令行会当场展开变量并保存它的值；要共享的 `.mcp.json` 请用下面的文件写法。

## `.mcp.json`（项目级）

```json
{
  "mcpServers": {
    "simail": {
      "type": "http",
      "url": "https://api.simail.ai/mcp",
      "headers": { "Authorization": "Bearer ${SIMAIL_API_KEY}" }
    }
  }
}
```

Claude Code 加载文件时才展开 `${SIMAIL_API_KEY}`，所以 key 不会进入仓库。提交 `.mcp.json` 时只保留变量引用。

## 检查

运行 `claude mcp list`，或在会话里输入 `/mcp`；`simail` 应显示为已连接，并列出它的工具。

## 建议的权限设置

发信前先询问。在 `.claude/settings.json` 中：

```json
{
  "permissions": {
    "ask": [
      "mcp__simail__send_message",
      "mcp__simail__reply_to_message",
      "mcp__simail__reply_all_message",
      "mcp__simail__forward_message",
      "mcp__simail__send_draft"
    ]
  }
}
```

工具返回的邮件内容是不可信的，见 [MCP 服务：不可信内容](/zh/mcp/)。