SendGrid MCP Server

MCP Market 会为你部署并托管此服务 — 无需本地安装，也无需在你的机器上管理环境变量。你仍需要一个 SendGrid API 密钥；你将在 MCP Market 中输入密钥，而不是输入到自己的 shell/配置中。

在 MCP Market 的 MCP Servers 页面中，从以下任一来源部署自定义 MCP：

• GitHub — 选择 GitHub 来源，选择 Public 或 Private 仓库，粘贴 仓库 URL（https://github.com/deyikong/sendgrid-mcp），并选择 服务名称。
• npm — 选择 npm 来源，输入软件包名称（sendgrid-mcp）， 并选择服务名称。

无论选择哪种方式，MCP Market 都会为你构建并运行服务；准备就绪后，它会显示在 MCP Servers 下，状态为 Running。继续前往 配置 MCP 客户端，设置你的 凭据并连接。

自行运行服务，并通过 Streamable HTTP 对外提供，而不是让 客户端在本地启动它 — 适用于 Claude 自定义连接器、OpenAI 的 Responses API mcp 工具 / Apps SDK，或任何其他远程客户端。

MCP 端点为 POST /mcp；GET /health 会返回供负载均衡器使用的状态文档。 请求以无状态方式处理（无需会话 ID）， 这正是托管客户端所期望的方式。

下方的 none/token/oauth 并非连接的替代方式 — 它们是 HTTP 这扇新门上的三种不同门锁，如 上方的请求流程图所示。

快速开始（本地开发）

export SENDGRID_API_KEY="SG.your_api_key_here"
export MCP_TRANSPORT=http
export MCP_AUTH_MODE=token
export MCP_AUTH_TOKEN="$(openssl rand -hex 32)"

sendgrid-mcp

身份验证

将 MCP_AUTH_MODE 设置为以下一种模式：

OAuth 模式会使此服务成为 OAuth 2.1 资源服务器。它不会 签发或存储凭据 — 它会根据现有身份提供商（Auth0、Okta、Entra ID、Google、Stytch，……）发布的 JWKS， 验证由该身份提供商签发的访问令牌。

export MCP_AUTH_MODE=oauth
export MCP_OAUTH_ISSUER="https://your-tenant.auth0.com"
export MCP_OAUTH_AUDIENCE="https://mcp.example.com"
export MCP_OAUTH_REQUIRED_SCOPES="sendgrid:read"
export MCP_PUBLIC_URL="https://mcp.example.com"

除上述配置外，还必须设置 SENDGRID_API_KEY（参见入门指南中的图示） — OAuth 只控制谁可以访问服务，不控制服务 使用什么与 SendGrid 通信。

服务会在 /.well-known/oauth-protected-resource 发布 RFC 9728 受保护资源元数据，以便客户端自动发现你的授权服务器：未经身份验证的 请求会收到一个 401，其 WWW-Authenticate 标头指向该文档， 客户端读取文档后会将用户引导至你的 IdP 登录，并携带 获取的令牌重试。

如果令牌已过期、签名错误，或签发者或受众不符，令牌会被拒绝（401）；如果有效令牌缺少必需的作用域，则会返回 403。

设置身份提供方

无论使用哪种提供方，你都需要配置相同的三项内容：颁发者 URL、受众（此 API 资源的稳定标识符），以及客户端将请求的作用域。以下是几个具体的配置指南：

export MCP_OAUTH_ISSUER="https://YOUR_TENANT.auth0.com/"
export MCP_OAUTH_AUDIENCE="https://mcp.example.com"
export MCP_OAUTH_REQUIRED_SCOPES="sendgrid:read"

export MCP_OAUTH_ISSUER="https://YOUR_OKTA_DOMAIN/oauth2/YOUR_AUTH_SERVER_ID"
export MCP_OAUTH_AUDIENCE="api://sendgrid-mcp"
export MCP_OAUTH_REQUIRED_SCOPES="sendgrid:read"

export MCP_OAUTH_ISSUER="https://login.microsoftonline.com/YOUR_TENANT_ID/v2.0"
export MCP_OAUTH_AUDIENCE="api://YOUR_CLIENT_ID"
export MCP_OAUTH_REQUIRED_SCOPES="sendgrid.read"

其他提供方（Google Identity Platform、Stytch 等）也遵循相同的模式：找到 OpenID Connect 颁发者（通常发布在 <issuer>/.well-known/openid-configuration），为此服务定义受众／资源标识符，并为其创建作用域。

无论使用哪种提供方，还要将 MCP_PUBLIC_URL 设置为服务可从外部访问的 URL（例如 https://mcp.example.com）——客户端会在 OAuth 发现过程中使用它。

TLS

可以在进程内终止 TLS：

export TLS_KEY_FILE=/etc/ssl/private/mcp.key
export TLS_CERT_FILE=/etc/ssl/certs/mcp.crt
export TLS_CA_FILE=/etc/ssl/certs/chain.pem   # optional intermediates

……也可以在代理处终止 TLS，并告知服务信任转发的标头：

export TRUST_PROXY=true
export MCP_PUBLIC_URL="https://mcp.example.com"

默认情况下，TRUST_PROXY 处于关闭状态，因为 X-Forwarded-* 标头可由客户端控制，除非你控制的代理会覆盖它们。在进程内模式下，强制要求最低使用 TLS 1.2。

连接客户端

OpenAI（Responses API）：

{
  "model": "gpt-5",
  "tools": [{
    "type": "mcp",
    "server_label": "sendgrid",
    "server_url": "https://mcp.example.com/mcp",
    "authorization": "ACCESS_TOKEN"
  }],
  "input": "List my SendGrid automations"
}

Claude（自定义连接器）： 将 https://mcp.example.com/mcp 添加为自定义连接器。在 oauth 模式下，Claude 会执行发现流程并提示用户登录；在 token 模式下，直接提供 bearer token。

安全

服务器会拒绝在存在可能悄然暴露你的 SendGrid 账户的配置错误时启动，而不会以弱于你预期的模式运行：

• 绑定到非环回地址，但既未启用 TLS，也未设置 TRUST_PROXY
• MCP_AUTH_MODE=none，但绑定地址不是环回地址
• MCP_PUBLIC_URL 使用 http://，且地址不是环回地址
• 未设置 MCP_AUTH_TOKEN 或其长度不足，或者在 oauth 模式下未设置签发方和受众
• TLS_KEY_FILE 和 TLS_CERT_FILE 只设置了其中一个

此外：

• 保持 READ_ONLY=true，除非你需要写入和发送操作。这是限制影响范围最有效的做法——它决定了泄露的令牌暴露的是分析数据，还是能从你的域名发送邮件。
• 设置 MCP_ALLOWED_HOSTS / MCP_ALLOWED_ORIGINS，以启用 DNS 重绑定保护；对于可从浏览器访问的本地绑定服务，这一点尤为重要。
• 将 SendGrid API 密钥的权限范围限制为此服务所需的权限；该密钥才是每个请求背后的真实凭据。

部署好服务后（参见安装服务）， 设置凭据并连接客户端。

设置环境变量

打开已部署的服务 → Variables 标签页 → My Credentials，然后 填写：

每个字段都会单独保存——只有 SENDGRID_API_KEY 是必填项。

连接客户端

在服务页面上点击 + Connect。MCP Market 提供 Claude Desktop、Claude Code、Codex CLI、Cursor、VS Code、Windsurf、Cline、JetBrains、Gemini CLI、Amazon Q、Goose 和 Continue 的一键安装选项——选择你的客户端并按照提示操作。

对于其他客户端，请使用 Connection URL 选项，它会提供一个专属于你部署的 Streamable HTTP 端点。以下示例使用 deyikong/sendgrid-mcp 进行说明——你的端点会使用你自己的用户名和服务名称：

https://link.mcpmarket.com/<your-username>/<your-server-name>/mcp

像配置其他可自托管端点一样进行配置，例如：

# Claude Code
claude mcp add --transport http sendgrid https://link.mcpmarket.com/<your-username>/<your-server-name>/mcp

# Codex CLI
codex mcp add sendgrid --url https://link.mcpmarket.com/<your-username>/<your-server-name>/mcp

MCP Market 负责管理已部署服务的托管、TLS 和可用性；有关账户、账单或部署的问题，请直接联系 MCP Market，而非本代码仓库。

支持原生 MCP 的 Claude 官方桌面应用。

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

配置：

{
  "mcpServers": {
    "sendgrid": {
      "command": "sendgrid-mcp",
      "env": {
        "SENDGRID_API_KEY": "SG.your_api_key_here",
        "READ_ONLY": "true"
      }
    }
  }
}

可选配置：

{
  "mcpServers": {
    "sendgrid": {
      "command": "sendgrid-mcp",
      "env": {
        "SENDGRID_API_KEY": "SG.your_api_key_here",
        "READ_ONLY": "false",
        "LOG_LEVEL": "info",
        "REQUEST_TIMEOUT": "30000"
      }
    }
  }
}

配置完成后：

1. 保存文件
2. 重启 Claude Desktop
3. SendGrid MCP 服务将在 Claude 中可用

支持 MCP 的 Claude 官方命令行界面。

安装：

npm install -g @anthropic-ai/claude-code

配置文件位置：

• 所有平台：~/.claude/config.json

配置：

{
  "mcpServers": {
    "sendgrid": {
      "command": "sendgrid-mcp",
      "env": {
        "SENDGRID_API_KEY": "SG.your_api_key_here",
        "READ_ONLY": "true"
      }
    }
  }
}

用法：

# Start Claude Code with SendGrid MCP
claude

# The SendGrid tools will be automatically available
# Ask Claude: "List my SendGrid automations"

支持 MCP 的热门 VS Code 扩展。

安装：

1. 从 VS Code marketplace 安装 Cline 扩展
2. 打开 Cline 设置

配置文件：

• 打开 VS Code 设置
• 搜索 "Cline: MCP Settings"
• 编辑 MCP 配置 JSON

配置：

{
  "mcpServers": {
    "sendgrid": {
      "command": "sendgrid-mcp",
      "env": {
        "SENDGRID_API_KEY": "SG.your_api_key_here",
        "READ_ONLY": "true"
      }
    }
  }
}

内置 AI 和 MCP 支持的现代代码编辑器。

配置文件位置：

• macOS/Linux：~/.config/zed/settings.json
• Windows：%APPDATA%/Zed/settings.json

配置：

{
  "context_servers": {
    "sendgrid-mcp": {
      "command": "sendgrid-mcp",
      "env": {
        "SENDGRID_API_KEY": "SG.your_api_key_here",
        "READ_ONLY": "true"
      }
    }
  }
}

支持 MCP 的 VS Code 开源自动驾驶助手。

配置文件位置：

• 所有平台：~/.continue/config.json

配置：

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "command": "sendgrid-mcp",
        "env": {
          "SENDGRID_API_KEY": "SG.your_api_key_here",
          "READ_ONLY": "true"
        }
      }
    ]
  }
}

适用于以上未列出的任何兼容 MCP 的客户端：

命令行：

# With environment variables
SENDGRID_API_KEY="SG.your_api_key_here" READ_ONLY="true" sendgrid-mcp

配置模板：

{
  "command": "sendgrid-mcp",
  "env": {
    "SENDGRID_API_KEY": "SG.your_api_key_here",
    "READ_ONLY": "true"
  }
}

为确保安全，SendGrid MCP 服务默认以只读模式（READ_ONLY=true）运行。所有工具都会注册并可用，但可变更操作会在运行时被阻止，并显示有帮助的错误消息。

只读模式的工作方式

当 READ_ONLY=true（默认值）时：

• 所有工具都会注册并对 AI 助手可见
• 非变更操作正常运行（列表、获取、搜索、打开浏览器链接）
• 变更操作会被阻止，并显示明确的错误消息：

  ❌ Operation blocked: Server is running in READ_ONLY mode. Set READ_ONLY=false in your environment to enable write operations.
  

只读模式下安全的操作

当 READ_ONLY=true 时，以下 32 项操作可正常运行：

自动化与营销活动：

• list_automations、get_automation、open_automation_creator、open_automation_editor
• list_single_sends、get_single_send、open_single_send_creator、open_single_send_stats

联系人、列表与细分：

• list_contacts、get_contact、search_contacts、search_contacts_by_emails
• list_email_lists
• list_segments、open_segment_creator
• list_custom_fields

发件人：

• list_senders、open_csv_uploader

模板：

• list_templates、get_template、get_template_version、open_template_editor

统计信息（均按设计为只读）：

• get_global_stats、get_stats_overview、get_stats_by_browser、get_stats_by_client_type、get_stats_by_device_type、get_stats_by_mailbox_provider、get_stats_by_country、get_category_stats、get_subuser_stats

实用工具：

• get_scopes

只读模式下被阻止的操作

当 READ_ONLY=true 时，以下 26 项操作会被阻止：

• update_automation_settings、update_automation_step、delete_automation
• create_contact、update_contact、delete_contact
• create_contact_with_lists、remove_contact_from_lists
• create_email_list、update_email_list、delete_email_list
• create_custom_field、update_custom_field、delete_custom_field
• create_sender、delete_sender
• update_segment、delete_segment
• create_template、update_template、delete_template
• create_template_version、update_template_version、delete_template_version
• create_html_template
• send_mail

完全访问模式

若要启用创建、更新、删除和发送操作，请在 MCP 客户端的 env 块中设置 READ_ONLY=false：

{
  "env": {
    "SENDGRID_API_KEY": "SG.your_api_key_here",
    "READ_ONLY": "false"
  }
}

这样即可正常执行所有变更操作，同时保留所有读取操作。

⚠️ 安全提示： 只有在需要写入权限且信任服务器运行环境时，才应关闭只读模式。

示例 — 获取自动化详情：

{
  "tool": "get_automation",
  "arguments": {
    "automation_id": "automation_id_here"
  }
}

示例 — 暂停整个自动化：

{
  "tool": "update_automation_settings",
  "arguments": {
    "automation_id": "automation_id_here",
    "status": "paused"
  }
}

示例 — 更新单个步骤（状态、等待时间）：

{
  "tool": "update_automation_step",
  "arguments": {
    "automation_id": "automation_id_here",
    "step_id": "step_id_here",
    "step_status": "active",
    "wait_time": 1440
  }
}

示例 — 删除自动化：

{
  "tool": "delete_automation",
  "arguments": {
    "automation_id": "automation_id_here"
  }
}

示例 — 获取活动内容和设置：

{
  "tool": "get_single_send",
  "arguments": {
    "singlesend_id": "singlesend_id_here"
  }
}

示例 — 创建新联系人：

{
  "tool": "create_contact",
  "arguments": {
    "contacts": [
      {
        "email": "[email protected]",
        "first_name": "Jane",
        "last_name": "Smith"
      }
    ]
  }
}

示例 — 按电子邮件搜索联系人：

{
  "tool": "search_contacts_by_emails",
  "arguments": {
    "emails": ["[email protected]", "[email protected]"]
  }
}

示例 — 使用查询条件搜索联系人：

{
  "tool": "search_contacts",
  "arguments": {
    "query": "email LIKE '@example.com'",
    "page_size": 10
  }
}

示例 — 更新联系人：

{
  "tool": "update_contact",
  "arguments": {
    "contacts": [
      {
        "id": "contact_id_here",
        "first_name": "John",
        "last_name": "Updated"
      }
    ]
  }
}

示例 — 删除联系人：

{
  "tool": "delete_contact",
  "arguments": {
    "contact_ids": ["contact_id_1", "contact_id_2"]
  }
}

示例 — 列出电子邮件列表：

{
  "tool": "list_email_lists",
  "arguments": {
    "page_size": 100
  }
}

示例 — 重命名电子邮件列表：

{
  "tool": "update_email_list",
  "arguments": {
    "list_id": "list_id_here",
    "name": "Updated List Name"
  }
}

示例 — 从列表中移除联系人：

{
  "tool": "remove_contact_from_lists",
  "arguments": {
    "list_id": "list_id_here",
    "contact_ids": ["contact_id_1", "contact_id_2"]
  }
}

示例 — 删除电子邮件列表：

{
  "tool": "delete_email_list",
  "arguments": {
    "list_id": "list_id_here"
  }
}

示例 — 重命名细分群组：

{
  "tool": "update_segment",
  "arguments": {
    "segment_id": "segment_id_here",
    "name": "Updated Segment Name"
  }
}

示例 — 更新细分群组的查询条件：

{
  "tool": "update_segment",
  "arguments": {
    "segment_id": "segment_id_here",
    "query_dsl": "{\"and\": [{\"field\": \"email\", \"value\": \"@example.com\", \"operator\": \"like\"}]}"
  }
}

示例 — 删除细分群组：

{
  "tool": "delete_segment",
  "arguments": {
    "segment_id": "segment_id_here"
  }
}

示例 — 创建自定义字段：

{
  "tool": "create_custom_field",
  "arguments": {
    "name": "customer_tier",
    "field_type": "Text"
  }
}

示例 — 更新自定义字段：

{
  "tool": "update_custom_field",
  "arguments": {
    "field_id": "field_id_here",
    "name": "customer_level"
  }
}

示例 — 删除自定义字段：

{
  "tool": "delete_custom_field",
  "arguments": {
    "field_id": "field_id_here"
  }
}

示例 — 创建发件人身份：

{
  "tool": "create_sender",
  "arguments": {
    "nickname": "Marketing Team",
    "from": { "email": "[email protected]", "name": "Your Company" },
    "reply_to": { "email": "[email protected]", "name": "Your Company" },
    "address": "123 Main St",
    "city": "Denver",
    "state": "CO",
    "zip": "80202",
    "country": "United States"
  }
}

示例 — 删除发件人身份：

{
  "tool": "delete_sender",
  "arguments": {
    "sender_id": "sender_id_here"
  }
}

示例 — 一步创建完整模板（最适合 AI Agent）：

{
  "tool": "create_html_template",
  "arguments": {
    "template_name": "Welcome Email",
    "version_name": "Version 1.0",
    "subject": "Welcome to {{companyName}}, {{firstName}}!",
    "html_content": "<!DOCTYPE html><html><head><meta charset=\"utf-8\"><title>Welcome</title></head><body style=\"font-family: Arial, sans-serif; max-width: 600px; margin: 0 auto;\"><h1 style=\"color: #333;\">Welcome {{firstName}}!</h1><p>Thank you for joining {{companyName}}. We're excited to have you on board.</p></body></html>",
    "test_data": "{\"firstName\":\"John\",\"companyName\":\"Acme Corp\"}"
  }
}

示例 — 添加包含 HTML 内容的新版本：

{
  "tool": "create_template_version",
  "arguments": {
    "template_id": "your_template_id",
    "name": "Newsletter v1.0",
    "subject": "{{month}} Newsletter - {{companyName}}",
    "html_content": "<!DOCTYPE html><html><head><meta charset=\"utf-8\"></head><body><h1>{{month}} Newsletter</h1>{{#each articles}}<div><h2>{{title}}</h2><p>{{summary}}</p><a href=\"{{link}}\">Read More</a></div>{{/each}}</body></html>",
    "test_data": "{\"month\":\"January\",\"companyName\":\"Acme\",\"articles\":[{\"title\":\"Article 1\",\"summary\":\"Summary here\",\"link\":\"https://example.com\"}]}"
  }
}

示例 — 发送简单邮件：

{
  "tool": "send_mail",
  "arguments": {
    "personalizations": [
      {
        "to": [{"email": "[email protected]", "name": "John Doe"}],
        "subject": "Hello from SendGrid MCP!"
      }
    ],
    "from": {"email": "[email protected]", "name": "Your Name"},
    "content": [
      {
        "type": "text/plain",
        "value": "Hello! This email was sent via SendGrid MCP server."
      }
    ]
  }
}

示例 — 使用动态模板发送邮件：

{
  "tool": "send_mail",
  "arguments": {
    "personalizations": [
      {
        "to": [{"email": "[email protected]", "name": "John Doe"}],
        "dynamic_template_data": {
          "firstName": "John",
          "companyName": "Acme Corp",
          "orderNumber": "12345",
          "items": [
            {"name": "Product A", "price": "29.99"},
            {"name": "Product B", "price": "19.99"}
          ]
        }
      }
    ],
    "from": {"email": "[email protected]", "name": "Your Company"},
    "template_id": "d-1234567890abcdef1234567890abcdef"
  }
}

示例 — 全局邮件统计数据：

{
  "tool": "get_global_stats",
  "arguments": {
    "start_date": "2024-01-01",
    "end_date": "2024-01-31",
    "aggregated_by": "day"
  }
}

示例 — 按邮箱服务商统计：

{
  "tool": "get_stats_by_mailbox_provider",
  "arguments": {
    "start_date": "2024-01-01",
    "end_date": "2024-01-07",
    "aggregated_by": "day",
    "mailbox_providers": "gmail.com,outlook.com,yahoo.com"
  }
}

示例 — 地理位置效果统计数据：

{
  "tool": "get_stats_by_country",
  "arguments": {
    "start_date": "2024-01-01",
    "end_date": "2024-01-31",
    "country": "US",
    "aggregated_by": "week"
  }
}

示例 — 综合统计概览：

{
  "tool": "get_stats_overview",
  "arguments": {
    "start_date": "2024-01-01",
    "end_date": "2024-01-07",
    "aggregated_by": "day",
    "include_subusers": false
  }
}

前置条件

• Node.js 20+ 和 npm
• 拥有 API 密钥的 SendGrid 账户
• Git

开发环境设置

# Clone the repository
git clone https://github.com/deyikong/sendgrid-mcp.git
cd sendgrid-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Link for local development
npm link

# Test the local build
sendgrid-mcp

在 MCP 客户端中使用本地构建版本（而不是通过 npm 安装的二进制文件）：

{
  "mcpServers": {
    "sendgrid": {
      "command": "node",
      "args": ["/absolute/path/to/sendgrid-mcp/build/index.js"],
      "env": {
        "SENDGRID_API_KEY": "SG.your_api_key_here",
        "READ_ONLY": "true"
      }
    }
  }
}

项目结构

src/
├── index.ts                    # Main entry point
├── shared/                     # Shared utilities
│   ├── auth.ts                 # Authentication
│   ├── api.ts                  # SendGrid API client
│   ├── env.ts                  # Environment validation
│   └── types.ts                # Shared types
├── tools/                      # Tool definitions
│   ├── automations.ts          # Automation tools (7 tools)
│   ├── campaigns.ts            # Campaign tools (4 tools)
│   ├── contacts.ts             # Contact, list, segment & sender tools (25 tools)
│   ├── mail.ts                 # Mail sending tools (1 tool)
│   ├── misc.ts                 # Miscellaneous tools (1 tool)
│   ├── stats.ts                # Statistics tools (9 tools)
│   └── templates.ts            # Template tools (11 tools)
├── resources/                  # Resource definitions
│   └── sendgrid.ts             # MCP resources
└── prompts/                    # Prompt definitions
    └── help.ts                 # Help prompts

添加新工具

1. 在 src/tools/ 中的相应文件里添加工具定义
2. 按照现有模式添加配置和处理程序
3. 从 src/tools/index.ts 导出
4. 更新 README.md，添加新工具的文档
5. 运行 npm run build 进行编译

可用脚本

• npm run build - 将 TypeScript 编译为 JavaScript
• npm start - 运行编译后的服务
• npm test - 构建并运行测试套件

测试更改

# Build the project
npm run build

# Test with environment variables
SENDGRID_API_KEY="SG.your_key" READ_ONLY="true" node build/index.js

如需手动验证真实客户端能否通过各种 HTTP 身份验证模式 （令牌、无身份验证、TLS、OAuth）连接，而不只是运行自动化测试套件，请参阅 TESTING.md。

创建发布版本

仅限维护者：

1. 更新 package.json 中的版本：

   npm version patch  # or minor, major
   

2. 推送更改和标签：

   git push && git push --tags
   

3. 创建 GitHub 发布版本——这会通过 GitHub Actions 触发自动发布到 npm

发布流程

• 自动化：创建发布版本时，GitHub Actions 会将软件包发布到 npm
• 来源证明：所有软件包都包含用于安全验证的来源证明
• 版本控制：遵循语义化版本控制（semver）
• 软件包：npm 上的 sendgrid-mcp ——使用 npm update -g sendgrid-mcp 更新

1. 找不到服务 / 找不到命令

Error: sendgrid-mcp: command not found

解决方法：

• 确认已全局安装：npm install -g sendgrid-mcp
• 检查 npm 全局 bin 目录是否在 PATH 中：npm config get prefix
• 尝试重新安装：npm uninstall -g sendgrid-mcp && npm install -g sendgrid-mcp

2. API 密钥无效

Error: SENDGRID_API_KEY must start with 'SG.'

解决方法：

• 确认 API 密钥以 SG. 开头
• 确认已从 SendGrid 复制完整密钥
• 检查配置中是否有多余的空格或引号
• 在 SendGrid API Keys 生成新的 API 密钥

3. 权限错误

Error: 403 Forbidden

解决方法：

• 您的 API 密钥可能没有足够的权限
• 创建一个具有“Full Access”或所需作用域的新密钥
• 确认该密钥尚未被撤销或过期

4. 只读模式阻止操作

❌ Operation blocked: Server is running in READ_ONLY mode

解决方法：

• 这是有意设置的安全保护
• 若要启用写入操作，请在 MCP 客户端配置中设置 READ_ONLY: "false"
• 示例：

  {
    "env": {
      "SENDGRID_API_KEY": "SG.your_key",
      "READ_ONLY": "false"
    }
  }
  

5. MCP 客户端未检测到服务

解决方法：

• 确认特定客户端的配置文件位置
• 确保 JSON 语法有效（没有尾随逗号，使用正确的引号）
• 更改配置后重启 MCP 客户端
• 检查客户端日志中的具体错误消息

6. 连接超时

Error: Request timeout

解决方法：

• 检查网络连接
• 在配置中增加超时时间：

  {
    "env": {
      "REQUEST_TIMEOUT": "60000"
    }
  }
  

• 确认可以访问 SendGrid API（未被防火墙/代理阻止）