跳转到主要内容
Krea 为智能体和编程助手提供托管的 Model Context Protocol (MCP) 服务器。当你希望兼容 MCP 的客户端直接调用 Krea，而不是手动编写 API 请求时，可以使用它。
连接无需 API 密钥。将 https://api.krea.ai/mcp 添加为 MCP 服务器 URL，然后通过客户端的 OAuth 流程使用你的 Krea 账户登录即可。

​
服务器详情

设置值
传输方式Streamable HTTP
URLhttps://api.krea.ai/mcp
身份认证OAuth
计费方式取决于你的认证方式：
认证方式计费来源
OAuth已登录 Krea 账户的计算单元
API token工作区独立的 API 余额

​
身份认证

大多数 MCP 客户端会自动使用 OAuth。当客户端要求你连接时，按照浏览器的登录流程并授权 Krea 即可。 OAuth 用量按计算单元计费，扣除自已登录的 Krea 账户。如果你的 MCP 客户端不支持 OAuth，可以改用 API token 进行认证：
请求头键请求头值
AuthorizationBearer KREA_API_TOKEN
将 KREA_API_TOKEN 替换为来自 krea.ai/app/api/tokens 的 token。只有工作区所有者和管理员可以创建 API token。 API token 用量按工作区的 API 余额计费，与直接调用 API 相同。API 余额详情请参阅 API 密钥与计费。
请像保管 API 密钥一样保管 API token MCP 凭据。不要将包含真实 token 的 MCP 配置文件提交到版本控制。

​
Claude Code

在终端中运行以下命令： 
claude mcp add --transport http krea-ai https://api.krea.ai/mcp
当 Claude Code 提示你连接时，使用你的 Krea 账户登录。添加服务器后，请重启 Claude Code 或重新加载 MCP 服务器。

​
Codex

  1. 在 Codex 中打开 Settings > MCP servers。
  2. 添加新服务器。
  3. 选择 Streamable HTTP 作为传输方式。
  4. 粘贴服务器 URL：
https://api.krea.ai/mcp
  1. 保存服务器，并在 Codex 提示连接时使用你的 Krea 账户登录。

​
Cursor

打开命令面板，搜索 Open MCP settings，然后将以下条目添加到 mcp.json： 
{
  "mcpServers": {
    "krea-ai": {
      "url": "https://api.krea.ai/mcp"
    }
  }
}
保存文件后重启 Cursor，并在 Cursor 提示连接时使用你的 Krea 账户登录。

​
通过 MCP 使用 Krea

连接后，可以让智能体列出 Krea 模型或在生成前检查模型 schema。模型 ID 与开发者文档其余部分使用的 API 路径相匹配，例如 image/krea/krea-2/medium 或 video/google/veo-3.1。 例如： 
List the available Krea image models, then generate an image with Krea 2 using a 16:9 aspect ratio.
如果某个模型已弃用，Krea 会通过 MCP 模型发现返回弃用元数据。迁移指引请参阅 弃用说明。

​
故障排查

问题解决方法
身份认证失败重新连接 MCP 服务器，并在浏览器中完成 Krea OAuth 流程。如果你使用 API token，确认请求头完全是 Authorization: Bearer KREA_API_TOKEN，且该 token 未被吊销。
客户端无法连接确认客户端已配置为 Streamable HTTP 并使用 https://api.krea.ai/mcp。
生成因计费问题被拒绝如果你通过 OAuth 连接，请检查已登录 Krea 账户的计算单元。如果你使用 API token 连接，请在 krea.ai/app/api 充值 API 余额。
模型调用失败在重试前让智能体检查模型 schema。MCP 请求使用与 API 相同的模型输入。

​
后续步骤

API 密钥与计费

创建 API token 并管理用于 token 认证请求的 API 余额。

交互式 Playground

在让智能体执行请求之前，先在 Krea 应用中试运行请求。

弃用说明

了解 MCP 如何暴露模型迁移元数据。

模型 API

浏览端点 schema 和模型参数。