Kourier

Kourier MCP 服务

面向 Kourier 的远程 Model Context Protocol (MCP) 服务——为编码 Agent 提供固定费率托管式 AI 推理。

使用 MCP 服务查询套餐、查看模型限制、配置编码客户端、启动需人工批准的订阅开通流程，以及提交与账户关联的反馈或错误报告。Kourier 通过兼容 OpenAI 和 Anthropic 的推理 API 提供 DeepSeek V4.1 Flash，不按 token 计费，也不限制请求量。套餐的区别在于并发数。

https://kourier.sh/mcp

传输方式： Streamable HTTP，无状态，返回 JSON。身份验证： 查询信息或开通订阅无需身份验证；submit_feedback 需要在连接的 Authorization: Bearer 标头中提供 Kourier API 密钥。

MCP 提供服务信息和设置说明，不提供模型推理。推理使用订阅 API 密钥，调用 https://api.kourier.sh/v1（兼容 OpenAI）或 https://api.kourier.sh/anthropic（兼容 Anthropic）。

此仓库介绍托管服务；无需安装或运行本地服务。在线 MCP 服务提供八个工具：四个只读信息工具、三个开通订阅工具，以及一个需身份验证的反馈工具。在专属推理密钥发放前，周期性计费和 Agent 访问权限都需要用户在浏览器中明确批准。

快速开始

Claude Code

claude mcp add --transport http kourier https://kourier.sh/mcp

Cursor / 使用 mcpServers 的客户端

将此条目添加到客户端的 MCP 配置中：

{
  "mcpServers": {
    "kourier": {
      "url": "https://kourier.sh/mcp"
    }
  }
}

不同客户端的配置格式各不相同；当客户端要求填写服务 URL 时，请使用上面的远程 Streamable HTTP URL。

连接后，请询问：“Kourier 有哪些套餐？如何配置编码客户端来使用它？”

添加此 MCP 服务不会更改为编码客户端提供支持的模型。请使用 get_setup_instructions，另行将 Kourier 配置为推理提供方。

工具

连接到 MCP 并使用信息或入门工具无需连接凭据。入门状态和完成入门需要 create_checkout_link 返回的私有 onboarding_token。只有 submit_feedback 需要 API 密钥 Bearer 标头。请勿将令牌和密钥写入日志、公开消息、报告内容或代码库。

工具	参数	功能
get_pricing	无	返回公开方案、月费、并发限制和用量上限信息。
get_models	无	返回所提供模型的确切 API 标识符以及上下文和输出限制。
get_api_key_instructions	无	说明如何注册控制面板、登录 Agent 以及使用 PKCE 进行 OAuth。不返回 API 密钥本身。
get_setup_instructions	可选的 harness	返回 oh-my-pi、claude-code、codex 或 openai-compatible 的配置指南。省略该参数即可获取通用的 OpenAI 兼容设置。
create_checkout_link	plan、client_name；可选的 harness	启动验证登录、Starter/Pro 定期购买和明确的 Agent 访问授权。返回浏览器链接和授权码；创建链接本身不会扣费或发放密钥。
get_onboarding_status	私有 onboarding_token	检查授权和权益状态。每五秒轮询一次；仅在状态为 ready 时完成，并在状态为 issued、denied 或 expired 时停止。
complete_onboarding	私有 onboarding_token	将状态为 ready 的入门流程兑换为专用、可撤销的推理密钥，此操作仅可执行一次。请妥善保存；发放后或交付状态不明时，切勿重试，应改为检查状态。
submit_feedback	kind、message；可选的 request_id、client_name	保存与账户关联的反馈或错误报告。需要在连接的 Authorization: Bearer 标头中提供 Kourier API 密钥，绝不可将其放在工具参数中。

例如，调用 get_setup_instructions 时传入：

{
  "harness": "claude-code"
}

该服务还提供 kourier-setup Markdown 资源和 configure_kourier 提示词，后者接受相同的可选 harness 值。

反馈和错误报告

使用 submit_feedback 发送产品反馈或报告 Kourier 错误。报告会关联到 API 密钥所属的账户。

身份验证和隐私

• 使用 Authorization: Bearer <your Kourier API key> 配置 MCP 连接。将密钥保存在客户端的私有凭据设置中；切勿将真实密钥添加到代码库配置中。
• 密钥必须有效、未过期且未被撤销，账户也不得被封禁。使用其他方面均有效的密钥报告问题，不需要有效的推理订阅。
• 无需此标头即可使用公开信息和入门工具。对于不支持自定义标头的客户端，这些工具仍可使用，但反馈功能需要支持标头的客户端。
• 仅发送用户愿意分享的信息。请勿包含 API 密钥、入门令牌、密码、个人数据以及私有代码或日志。经过脱敏的 Kourier 请求 ID 有助于调查错误。

参数

参数	必填	值
kind	是	产品反馈使用 feedback，错误报告使用 error。
message	是	非空白文本；去除首尾空白后长度为 1–8,000 个字符。报告错误时，请说明预期行为、实际行为和复现步骤，不要包含私有数据。
request_id	否	与错误相关的 Kourier 请求 ID；去除首尾空白后长度为 1–200 个字符。
client_name	否	客户端或 harness 的名称和版本；去除首尾空白后长度为 1–80 个字符。

不接受 NUL 字节、传入的空白字符串、额外字段和凭据参数。

示例

使用有效密钥运行以下命令时，会保存一份反馈报告。请将示例消息替换为用户已批准的反馈，并在运行前将 KOURIER_API_KEY 私密地设置在环境中：

curl https://kourier.sh/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer $KOURIER_API_KEY" \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "submit_feedback",
      "arguments": {
        "kind": "feedback",
        "message": "Please add more coding-client setup examples to the documentation.",
        "client_name": "curl"
      }
    }
  }'

成功提交后，result.structuredContent 中会返回包含 id 和 created_at 的回执；同一回执也会以 JSON 文本形式包含在 result.content 中。工具失败时，result.isError 会设为 true，并返回 error 和 error_description。

• unauthorized — 配置有效的 Kourier API 密钥承载令牌标头。
• invalid_arguments — 更正提交的字段，并遵守上述限制。
• rate_limited — 等待 retry_after 中指定的秒数后再重新提交。
• service_unavailable — 无法确认回执。报告可能已保存；请勿盲目重试，因为再次提交可能会创建重复报告。

托管推理

方案

方案	月价（美元）	并发请求数
Starter	$20	1
Pro	$50	3

这两种公开方案都没有五小时、每周或每月的请求数或令牌配额。请求完成后，并发名额即可释放。“无使用配额”并不意味着可以无限并发请求。

请查看 get_pricing 或价格页面了解当前条款；MCP 端点接受 JSON-RPC POST 请求，而非普通的浏览器 GET 请求。

模型和端点

设置	值
模型	DeepSeek V4.1 Flash
精确的 API 模型标识符	deepseek-v4.1-flash
OpenAI 兼容的基础 URL	https://api.kourier.sh/v1
Anthropic 兼容的基础 URL	https://api.kourier.sh/anthropic
提示词与输出合计的最大上下文长度	262,144 个令牌（256K）
每次响应的最大输出长度	16,384 个令牌
身份验证	Authorization: Bearer <key>；Anthropic 接口也接受 x-api-key

请使用精确的模型标识符；不支持别名。请查看 get_models 和模型文档，了解当前可用情况和限制。

开始连接

1. 创建账户。
2. 在 Billing 中选择 Starter 或 Pro。
3. 在 Dashboard → API Keys 中创建 API 密钥。
4. 调用 get_setup_instructions 获取适用于你客户端的设置，并应用返回的配置。

如需 Agent 协助登录，请按照 Kourier 的 auth.md 和 Agent 登录指南操作。人工审批在浏览器中完成；仅连接到公开 MCP 服务并不会授权计费或授予推理访问权限。

请将 API 密钥保存在环境变量或客户端的私密凭据存储中。切勿将其提交到代码仓库或粘贴到公开问题中。公开信息工具不需要你的推理密钥。

使用 curl 发起推理请求

订阅已生效且环境中已设置 KOURIER_API_KEY 时：

curl https://api.kourier.sh/v1/chat/completions \
  -H "Authorization: Bearer $KOURIER_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Explain what this coding API supports."}],
    "max_tokens": 256
  }'

验证 MCP 连接

发送不带 API 密钥的初始化请求：

curl https://kourier.sh/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": {"name": "kourier-quickstart", "version": "1.0.0"}
    }
  }'

响应会将服务器标识为 kourier-info，并公布工具、资源和提示词。支持的协议版本为 2025-11-25、2025-06-18 和 2025-03-26。

列出可用工具：

curl https://kourier.sh/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

该端点不提供持久 SSE 流或 MCP 会话。GET 和 DELETE 会返回 405；请使用 JSON-RPC POST。普通 MCP 客户端会自动处理协议初始化。

链接

托管服务已发布在官方 MCP Registry，名称为 sh.kourier/info。此代码仓库包含用于注册表元数据的 server.json、用于维护者验证的 glama.json，以及用于在 LobeHub 发布的 lhm.plugin.json。目录账户验证和审核与注册表发布相互独立。

• 网站： kourier.sh
• 定价： kourier.sh/pricing
• 控制面板： app.kourier.sh
• 文档： docs.kourier.sh/docs
• Agent 登录： kourier.sh/auth.md
• MCP 服务卡片： kourier.sh/.well-known/mcp/server-card.json
• 设置技能： kourier-setup/SKILL.md

如需更正文档，请在此代码仓库中提交 issue。如需账户或账单方面的帮助，请使用 Kourier 网站或控制面板上的支持选项；请勿在此处透露账户凭据。