用 MCP 接入智能体

连接网址： https://mcp.kurv.fun/mcp

这个远程 MCP 让获得授权的智能体读取 KURV 合集、规划生成式合集、保存归你所有的草稿、上传真实的属性作品，并准备一个创作者核对链接。本版本使用 Base Sepolia，chain id 84532，不会在其他任何网络上发行。它从不持有创作者的私钥。

公开的开发者入口是 https://testnet.kurv.fun/builders。HTTP API、iframe 集成和直接合约铸造的说明，见直接合约集成。较早的本地 packages/mcp 服务器是一个独立的文件系统工具；这个远程连接器不需要访问创作者的电脑。

选择你的客户端

KURV 使用支持 OAuth 的远程 HTTP MCP 服务器。支持这种连接的客户端可以发现工具，并请你授权你的 KURV 账户。不支持远程 MCP 的普通聊天产品，需要另外一个兼容的智能体，或者你自己构建的应用；把网址粘贴到聊天中并不会安装连接器。

要完成默认的创作者连接，你需要已经有 KURV 邀请。 这个连接除了读取权限外，还会请求写入合集和准备发行的权限。公开的合集 API 无需邀请或 OAuth 授权即可使用。刻意只请求 kurv:read 的自定义客户端，会使用一个单独的只读授权。

系列	可以沿用什么
ChatGPT / Codex	共享同一套插件系统和目录。本地的 Codex MCP 设置在同一台主机上的桌面端、CLI 和 IDE 之间通用；它们不会安装 ChatGPT 网页版插件。
Claude / Claude Code	网页版连接器可以在同一个订阅账户下沿用到 Claude Code。使用 API 密钥和第三方服务商的会话需要单独设置。
Grok / Build / Bot	跨产品共享尚未核实。Build 使用它自己的 MCP 配置和 OAuth。Bot 连接器可以在你自己的各个 bot 之间沿用；Team Bot 的每位成员需要各自授权。

官方参考：OpenAI 插件、Codex MCP、Claude 账户连接器、Grok Bot 连接器和 Grok Build 配置。

本指南使用与接入你的智能体相同的客户端目录。请按你使用的宿主应用来选择，而不是只看模型。安装快捷方式只会添加配置；你仍需授权你自己的账户。

文档确立了设置路径。下面的验证一列，指的是在该客户端中真实建立的 KURV 连接：授权、工具发现和一次只读的工具调用。服务器的健康检查响应是另一项证据。

客户端	受众和工作流	文档依据	KURV 验证	位置	原因
ChatGPT	在对话中规划合集的创作者。和智能体一起打磨概念、准备草稿。	已有文档说明远程流式 HTTP、OAuth、CIMD 和 DCR。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	从这里开始	基于账户插件流程的对话式入口。
Claude	准备合集概念和属性方案的创作者。规划图层、校验合集并准备核对。	已有文档说明远程自定义连接器和浏览器 OAuth。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	从这里开始	带有自定义连接器入口的对话式工作流。
Grok	已经在使用 Grok 的创作者。用现有的聊天来规划和准备合集。	已有文档说明自定义 MCP 连接器和 OAuth；客户端往返流程尚待完成。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	从这里开始	让习惯对话的创作者留在他们已有的客户端中。
Codex	用文件和桌面智能体构建的创作者。准备属性素材、校验方案并上传草稿。	已有文档说明可流式 HTTP、OAuth 和共享的本地配置。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	从这里开始	既有桌面端设置路径，也有终端命令。
Claude Code	使用本地作品和脚本的创作者。从项目中准备属性文件和合集草稿。	已有文档说明远程 HTTP、OAuth，以及同一账户下 Claude 连接器的复用。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	更多客户端	实用的本地工作流；终端设置归入更多选项。
Cursor	在 Cursor 中开发作品或网站的创作者。生成本地属性文件并准备合集草稿。	已有文档说明远程 HTTP、OAuth 和原生 MCP 安装链接。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	更多客户端	带有原生安装快捷方式的编辑器工作流。
VS Code · GitHub Copilot	在 VS Code 中使用 Copilot 的创作者。处理属性文件、生成器和合集集成。	已有文档说明远程 HTTP、OAuth/DCR 和原生 MCP 安装链接。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	更多客户端	独立的 Copilot 设置，带有原生安装快捷方式。
Gemini CLI	在本地终端中使用 Gemini 的创作者。准备属性文件并校验生成式合集的输入。	已有文档说明可流式 HTTP、OAuth 发现和动态注册。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	更多客户端	有文档说明、需要显式浏览器登录的终端集成。
Grok Build	在本地项目中使用 Grok Build 的创作者。构建属性素材并准备合集草稿。	已有文档说明远程 HTTP 注册和 OAuth 诊断。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	更多客户端	独立的终端设置，已经安装时很实用。
OpenCode	在 OpenCode 中自选模型的创作者。用 DeepSeek 驱动的智能体准备作品和草稿。	已有文档说明 OpenCode 远程 MCP 和 OAuth；模型凭据是分开的。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	更多客户端	一套宿主配置即可支持多个模型服务商。
Grok Bot	使用现有 Grok Bot 的团队。通过已授权的团队 bot 准备合集。	已有文档说明远程 HTTPS MCP 和按人授权；确切的自定义设置尚未核实。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	高级集成	团队管理和尚未核实的添加对话框，需要进阶指引。
Bankr	已经在使用 Bankr 的创作者。如果服务商授权可用，可以用它的智能体准备合集。	已有文档说明自定义 HTTP MCP；OAuth 服务商的开放范围仍然有限。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	高级集成	OAuth 按服务商逐步开放，因此无法笼统地说连接可用。
DeepSeek Harness	构建自己智能体宿主的开发者。把合集规划工具集成到自定义应用中。	HTTP 传输接受请求头；当前的传输源码并未确立自动 OAuth。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	高级集成	宿主必须自行实现浏览器授权和令牌刷新。
Muse	在 muse.ai 上使用 Muse 的创作者。可能通过自定义连接器规划合集。	已有文档说明自定义连接器和经过审核的服务商集成；尚未确立面向终端用户的直接 MCP 流程。核实于 2026-10-08。	OAuth：未验证；发现：未验证；读取：未验证。	暂缓	公开安装任意 MCP，以及兼容的账户授权，仍未核实。

从这里开始

ChatGPT

添加一个 Personal 插件，然后在 Work 中使用。

能否使用自定义 MCP，取决于你的账户和工作区设置。

打开 Plugins → + → Add custom MCP server。
将它命名为 KURV，粘贴上面的网址，并选择 OAuth。如果有 CIMD 选项就选它；DCR 也可以。
创建它，并安装到 Personal 中。登录 KURV 并批准访问。
在 Work 聊天中选择 @KURV，然后使用开始提示词。

菜单和访问权限取决于你的账户和工作区设置。

如果设置失败： 如果没有 Add custom MCP server，请检查你的账户和工作区设置。授权之后，先在聊天中选择这个插件，再运行连接检查。

参考：打开 ChatGPT 插件、官方自定义 MCP 设置。

Claude

在 Claude 的 Connectors 页面添加 KURV。

免费账户只能添加一个自定义连接器。Team 和 Enterprise 需要由所有者先添加。移动端设置处于 beta 阶段。

打开 Connectors → Add custom connector。有些界面布局使用 + Add 或 Add → Custom → Web。
将它命名为 KURV，并粘贴网址。完成连接器的登录步骤，如果有 Use Claude’s published identity 选项就选择它。高级 OAuth 字段留空。
添加 KURV，登录并批准访问。
在聊天中启用 + → Connectors → KURV，然后使用开始提示词。

免费账户：一个自定义连接器。Team/Enterprise：由所有者先添加。移动端设置处于 beta 阶段；已有的连接在移动端可以正常使用。

如果设置失败： 如果在受管理的工作区中无法添加连接器，请让工作区所有者启用它。如果聊天中看不到工具，请在该聊天中启用连接器，然后重新进行连接检查。

参考：打开 Claude 连接器、Claude 连接器说明。

Grok

在 Grok 中添加一个自定义连接器。

这个连接必须在你的 Grok 账户中实际验证。工作区管理员可能需要启用自定义连接器。

打开 Connectors → New Connector → Custom。
将它命名为 KURV，粘贴网址，然后按照 OAuth 登录流程操作。
批准 KURV 的访问，然后让 Grok 读取你的 KURV 账户。

Business 和 Enterprise 可能需要管理员先配置连接器。

如果设置失败： 如果没有 Custom 选项，请检查工作区管理设置。如果授权失败，请记下确切的错误信息，并在排查连接期间改用另一个有文档说明的客户端。

参考：打开 Grok 连接器、Grok 自定义连接器说明。

Codex

使用 Codex 的 Settings，或者下面的命令。

桌面端：Settings → MCP servers → Add server。将它命名为 KURV，选择 Streamable HTTP，并粘贴网址。
保存，如有提示就重启，然后选择 Authenticate。也可以运行下面的 CLI 命令。
登录 KURV，批准访问，然后在 Codex 会话中使用开始提示词。

Codex 命令

codex mcp add kurv --url https://mcp.kurv.fun/mcp
codex mcp login kurv

ChatGPT 和 Codex 共享同一套插件系统。直接的 MCP 设置，在同一台主机上的 Codex 桌面端、CLI 和 IDE 之间共享；它们不会安装 ChatGPT 网页版插件。

如果设置失败： 如果找不到服务器，请确认 MCP 配置位于运行当前 Codex 会话的主机上。如果授权已过期，请重新运行登录命令，然后重新打开会话。

参考：Codex MCP 说明。

高级集成

Grok Bot

在 Grok Bot 中使用 Remote HTTPS MCP 插件。

确切的自定义安装对话框仍未核实。每位团队成员都必须授权自己的账户。

打开 Marketplace 或 Your plugins。按照链接中的指南，设置自定义的 Remote HTTPS MCP。
使用上面的 KURV 网址和 OAuth。登录并批准对你自己账户的访问。
把插件挂接到你的 bot 上，然后使用开始提示词。

确切的添加对话框尚未核实。可能需要团队管理员启用插件；每个人都要授权自己的账户。

如果设置失败： 检查团队插件权限和你自己的授权。按照服务商关于当前添加对话框的说明操作；不要以为队友的授权就能让你的 bot 访问账户。

参考：Grok Bot 团队说明。

Bankr

在 Bankr 终端的 MCP 设置中添加 KURV。

Bankr 正在逐步开放 OAuth 服务商。对 KURV 的支持尚未核实。

打开终端的齿轮菜单 → MCP Servers → + Add。
粘贴上面的 KURV 网址，为 KURV 选择 HTTP，并启用 OAuth。
选择 Connect。如果 Bankr 打开了 KURV，请登录并批准访问。
连接之后，先运行只读的连接检查，再使用开始提示词。

如果 Bankr 返回 OAuth 错误，请暂时改用列出的其他客户端。

如果设置失败： 如果 OAuth 不可用，或返回服务商错误，不要把账户令牌粘贴到请求头中。在 Bankr 支持这个服务商之前，请使用其他有文档说明的客户端。

参考：打开 Bankr 终端、Bankr MCP 说明。

DeepSeek Harness

在使用平台的账户工具之前，先构建一个支持 OAuth 的适配层。

这个宿主还没有现成可用的 OAuth 设置。静态的授权请求头，不能替代一个持续维护的按用户登录流程。

阅读你要集成的版本的传输实现和 MCP 客户端指南。
在你的宿主中实现按用户的 OAuth 发现、PKCE 授权和刷新。把用户的授权与模型凭据分开保管。
在启用草稿相关操作之前，先验证授权、工具发现和一次只读的账户调用。

使用搭配 DeepSeek 的 OpenCode，走有文档说明的交互式登录路线。不要把会话令牌复制到共享配置中。

如果设置失败： 如果工具发现返回授权错误，请先完成宿主的按用户 OAuth 实现，再重试。交互式路线请使用 OpenCode，而不是共享会话令牌。

参考：DeepSeek Harness MCP 客户端、DeepSeek Harness 传输源码。

暂缓

Muse

产品已经确认。它的平台连接仍需核实。

Muse 不作为可用连接提供。它的自定义连接器和服务商审核流程，并不构成直接的 MCP 安装。

可以向 Muse 咨询 Custom Connector，或查阅它的服务商流程。在探索设置时，不要输入任何平台密钥。公开目录的审批，以及预期工具是否符合资格，都必须单独评估；现行准则限制资金转账和交易下单类工具。

参考：Muse 自定义连接器、Muse 服务商准则、打开 Muse。

检查你的连接

授权之后，在请求修改合集之前，先使用这个只读检查：

Use the KURV MCP connection to call kurv_account and kurv_builder_spec. Tell me the authorized wallet, network, chain ID, permissions and invitation status, and summarize the supported collection inputs. Expect Base Sepolia, chain 84532. Do not create a draft, upload art, prepare a launch or send a transaction. If a tool or permission is unavailable, report the exact issue instead of claiming the connection works.

出现错误，或者客户端无法发现工具，都需要排查。这项检查不会发送任何钱包交易。创作者的发行核对和钱包批准，仍然是单独的步骤。

开始一个合集

连接检查成功后，用这个提示词开始创作者工作流：

Help me create a generative NFT collection on KURV. First check my account and read the builder guide. Ask me for the concept, supply, real trait art and sale terms. Validate the plan, create a draft and help me upload the art. When it is ready, give me the launch review link. I will review and approve the wallet transactions.

个人连接和公开上架

通过服务器网址添加 KURV，创建的是你自己的客户端连接。品牌化的公开 ChatGPT/Codex 插件，需要经过验证的发布者、域名验证、可正常运行的 OAuth 集成、审核材料和批准。添加个人 MCP 服务器，并不会自动带来一个共享的公开上架。OpenAI 的公开插件准则把商业行为限制在实体商品范围内，并禁止数字代币销售和加密货币交易。KURV 的提交除了发布者验证和审核之外，还需要进行资格和范围评估。无论是人工的钱包批准，还是网络的选择，都不能确立资格。Claude 的目录有它自己的提交和审核流程，与 OpenAI 的相互独立。

对于 Claude，付费套餐的开发者可以通过目录开发者门户，把远程服务器网址作为 MCP connector 提交。Team 和 Enterprise 的提交需要相应的组织角色。自定义网址连接使用相同的连接器运行环境，无需公开的目录上架也能使用。在相应平台批准并发布之前，不要把 KURV 的上架说成已经发布。

官方指南：OpenAI 插件快速入门和 Claude 目录发布。

连接你的 KURV 账户

配置好你选择的兼容客户端之后：

按照它的浏览器授权提示进入 KURV。通过现有的账户流程登录。它会创建或连接你的 KURV 账户所使用的钱包。不要输入助记词、私钥或复制来的浏览器 Cookie。
检查批准会发往哪里。授权确认页会显示你的客户端将返回的主机，并把任何 KURV 不认识的客户端标记为未验证，因为任何客户端都可以用任何名字注册。查看所请求的权限，然后批准或拒绝这个连接。批准会绑定到那个账户和那次浏览器请求。
让你的智能体先调用 kurv_account 和 kurv_builder_spec。创建合集、上传作品和准备发行都需要已有的邀请。
准备好发行之后，用同一个 KURV 账户亲自打开核对链接。核对作品和发售条款，确认智能体设置的创作者分成和版税，导入项目，渲染并发布，然后批准钱包交易。收款方永远是你自己的账户：智能体无法指定收款方。

默认的创作者连接会请求下面全部三项权限，并且要求在授权完成之前已有邀请。如果没有邀请或邀请已被撤销，OAuth 会返回拒绝访问的结果，而不会授予创作者权限。自定义 MCP 客户端可以只请求 kurv:read 授权；服务器会在每个工具上单独检查写入合集和准备发行的权限。公开的 HTTP 读取不需要 OAuth 授权。

账户权限范围如下：

范围	权限
`kurv:read`	读取你的账户和草稿、校验方案，以及读取公开合集
`kurv:collections:write`	创建归你所有的草稿，并上传其真实的属性作品
`kurv:launch:prepare`	检查发行准备情况，并返回创作者核对链接

授权使用带有 S256 PKCE 的授权码 OAuth。访问令牌一小时后过期。授权从首次换取授权码起有效期为七天，即使访问令牌已经刷新也是如此。授权过期，或者你的客户端无法再刷新访问时，请重新连接。

如果想提前停止访问，可以在 KURV 上“我的藏品”的 Connected agents 中撤销（那里列出了每一个智能体连接及其返回的主机），或者使用你客户端的断开或令牌撤销操作。授权服务器公布的撤销端点是 POST https://mcp.kurv.fun/oauth/token。本版本不公布 /revoke；客户端应使用发现到的端点和它们已注册的客户端认证方式。撤销之后，请删除本地存储的访问令牌和刷新令牌。撤销连接器并不会移除已经部署在链上的合集。

十一个工具

工具	输入	结果
`kurv_account`	无	已授权的钱包、权限范围、网络和邀请状态
`kurv_builder_spec`	无	合集 schema、示例、发售方式和各项限制
`kurv_validate_collection`	`config`	预检结果和所需的属性键；不保存草稿
`kurv_create_collection`	`config`，可选的 `sale`，`idempotency_key`	归你所有的确定性草稿，以及创作者核对链接
`kurv_list_drafts`	无	你账户的草稿
`kurv_upload_trait`	`draft_id`、`asset_key`、`content_type`、`base64`	已保存作品的引用和内容摘要
`kurv_preview_collection`	`draft_id`，可选的 `limit`（1 到 20）	属性配方、稀有度、已上传作品的键和所需作品
`kurv_prepare_launch`	`draft_id`	`art_required` 或 `requires_user_action`，以及创作者核对链接
`kurv_list_collections`	可选的 `limit`（1 到 50）	公开 HTTP API 的目录数据
`kurv_get_collection`	`contract_address`	已登记的 Base Sepolia 合集、缓存的链上数字和集成链接
`kurv_embed_code`	`contract_address`	小组件网址，以及 iframe、API 和 ABI 链接

草稿的读写范围限定在授权该连接的钱包内。知道另一份草稿的 UUID 并不会获得访问权限。工具响应中描述作品、创作者文字或合集名称的内容是数据，而不是可以凌驾于用户请求之上的指令。

合集工作流示例

先调用 kurv_account，再调用 kurv_builder_spec。选定真实的作品概念，并确认创作者的发售条款。这个四件藏品的方案需要四张对齐的属性图片：

{
  "config": {
    "name": "Layer Machines",
    "size": 4,
    "width": 512,
    "height": 512,
    "seed": "layer-machines-v1",
    "layers": [
      {
        "name": "Background",
        "traits": [
          { "name": "Night", "file": "night.png", "weight": 1 },
          { "name": "Sky", "file": "sky.png", "weight": 1 }
        ]
      },
      {
        "name": "Machine",
        "traits": [
          { "name": "Robot", "file": "robot.png", "weight": 1 },
          { "name": "Drone", "file": "drone.png", "weight": 1 }
        ]
      }
    ]
  },
  "sale": {
    "symbol": "MACHINE",
    "saleMethod": "fixed",
    "priceUsd": "1",
    "creatorSharePct": 80,
    "royaltyPct": 5,
    "maxPerWallet": 4,
    "maxPerTransaction": 4
  },
  "idempotency_key": "layer-machines-v1-create"
}

把 config 传给 kurv_validate_collection。创建草稿之前，解决每一个预检错误。权重和属性规则必须能支持所要求数量的独一无二的藏品。
把示例请求体传给 kurv_create_collection。保存返回的 draft.id 和核对链接。任何重试都要发送相同的请求体和相同的幂等键。在同一个键下发送改动过的请求体会被拒绝；新的草稿必须使用新的键。保存的草稿在多次重试之间会保留它的种子和发售盐值。
通过 kurv_upload_trait，为 Background/night.png、Background/sky.png、Machine/robot.png 和 Machine/drone.png 上传真实的图片字节。asset_key 必须严格是 <layer.dir or layer.name>/<trait.file>。发送带有正确内容类型的规范 base64 字节，而不是网址或编造的占位字符串。
调用 kurv_preview_collection，检查属性组合和所需作品列表。这个响应是配方和稀有度数据，不是渲染好的位图。实际的合成效果要在创作者的核对和导入流程中查看。
调用 kurv_prepare_launch。如果状态是 art_required，上传它列出的所需素材。如果状态是 requires_user_action，把核对链接和需要在浏览器中完成的步骤交给创作者。transactions_sent: 0 是预期的结果。
创作者打开链接，核对并导入真正的作品，用 KURV 现有的流程渲染和发布，核对发售条款，然后签署钱包交易。准备好的草稿并不是已部署的合集。只有在拿到确认的部署回执之后，才能报告发行成功。
拿到已部署的地址后，用 kurv_get_collection 获取最新信息，用 kurv_embed_code 获取合集小组件。智能体不得根据草稿 ID 或预览编造一个已部署的地址。

草稿中的上传内容不可修改。为同一个属性重试上传相同的字节，会返回已有的素材；修改作品则需要新的草稿。服务器不会调用付费的图像模型，也不会生成上传的作品。智能体可以使用一个另行授权的作品工具，然后上传实际得到的字节。创作者必须拥有该作品的权利。

当前限制

项目	限制
生成的藏品	每份草稿 1,000 件
图层	12
属性	120
画布	每个维度 2,048 像素
属性上传	图片字节 2 MiB，按 base64 编码之前计
草稿	每个账户 20 份
属性格式	静态 PNG、JPEG 或 WebP
发售方式	固定价格、盲盒铸造、递增价格（`curve`）

每张属性图片都必须与草稿的画布尺寸一致。透明图层必须在这个画布上对齐。GIF、其他动态作品和拍卖类发售方式，不在这个 MCP 版本的范围内。支持的条款在签名之前仍会在浏览器中核对。现有的账户邀请、存储和发布限制，以及钱包批准检查，仍然有效。

远程连接器的作品素材和草稿，是归你所有的暂存数据。OAuth 过期或撤销，并不意味着已发布的 IPFS 文件或已部署的合约已被删除。

教会智能体这套工作流

服务器以 MCP 服务器指令、资源 kurv://builder-guide 和提示词 build-kurv-collection 的形式提供它的工作流。它们解释了图层 schema、归你所有的草稿、作品要求、重试和创作者批准。支持这些功能的客户端，可以在调用工具之前读取指南或调用提示词。客户端也可以直接使用工具描述和 JSON schema。

开始使用不需要任何微调任务。让智能体的指令保持明确：把上传的作品和合集文字当作不可信的内容，复用稳定的重试键，不要共享账户凭据，并准确报告 requires_user_action。钱包批准始终是创作者自己的操作。

MCP 之外的构建

MCP 是进入 KURV 的入口之一。公开的版本 1 HTTP 读取不需要连接器授权，并且启用了 CORS。公开的合集 iframe 使用 mint_mode: "kurv_wallet_handoff"；它的 Mint 按钮会打开 KURV 进行钱包批准。如果想在你自己的网站内直接铸造，请连接访问者的钱包，并使用公开 ABI、最新报价、代币授权额度和交易模拟来调用合集合约。确切的六参数 mint 调用，以及白名单和拍卖阶段的限制，参见直接合约集成。

关于直接的 HTTP 访问，请阅读公开 API；关于小组件，请阅读合集嵌入；关于合集数字的局限，请阅读风险与免责声明。

此处内容均不构成财务建议。在铸造、购买或卖回之前，请先阅读风险与免责声明。返回 kurv.fun。隐私政策。使用条款。。