文档
从你拥有的 API 到上线的 MCP Server，一步步来。
快速上手
以下步骤全部在网页控制台完成：注册账号，点击“新建项目”，按三步走即可，无需任何 API key。
-
导入你的 API
提供 OpenAPI 规格 URL、curl 命令或 Postman collection——Invokera 会把它转换成带类型的 MCP 工具。
-
验证域名归属
通过 DNS TXT 记录或 well-known 文件证明你拥有 API 所在的域名。
-
发布
上线后，你的项目会获得 MCP 端点、REST 端点和一个 AI 可读的落地页。
成功长什么样
一个真实项目的四个关键时刻，对照着确认你走在正轨上。 看看线上成品：Invokera Status demo 项目。
三种导入方式
OpenAPI（URL）
把公开的 OpenAPI/Swagger 规范 URL 粘贴到控制台的 OpenAPI 标签页——这是最快、最完整的导入方式。
curl
把一条可运行的 curl 命令粘贴到控制台的 curl 标签页——Invokera 会从中推导出带类型的工具。例如：
curl https://api.example.com/v1/users -H "Authorization: Bearer KEY"Postman
在 Postman 中把 collection 导出为 Collection v2.1 JSON，然后把 JSON 粘贴到控制台的 Postman 标签页。
域名验证排错
验证会检查 _invokera-challenge.<你的域名> 上的 TXT 记录（或 /.well-known/invokera-challenge.txt 文件）。每个挑战有效期 72 小时、最多校验 30 次。常见失败原因：
| 现象 | 可能原因 | 处理办法 |
|---|---|---|
| 明明加了记录，仍提示 "TXT record not found" | 多数 DNS 面板（Cloudflare、阿里云、腾讯云、GoDaddy）会自动在记录名后拼接你的域名——填完整名称会变成 _invokera-challenge.example.com.example.com。 | 记录名/主机记录只填 _invokera-challenge；仅当面板明确要求完整域名（FQDN）时才填全称。 |
| token 看起来没错，却提示值不匹配 | 值里混入了引号或空白——部分面板会把你粘贴的引号原样存进值里。 | 只粘贴 token 本身，不要带引号和空格；需要引号时面板会自行添加。 |
| 记录已添加，但验证仍然失败 | DNS 修改需要几分钟（有时更久）才能全网生效。 | 等几分钟后重试；可用 nslookup -type=TXT _invokera-challenge.<你的域名> 自查是否已生效。 |
| 记录加在了 api.example.com 这类子域名上 | 验证针对的是可注册主域名（eTLD+1），如 example.com，而不是子域名。 | 把 TXT 加在 _invokera-challenge.example.com；托管平台的共享子域名请改用 .well-known 文件方式。 |
| 提示挑战已过期或尝试次数过多 | 每个挑战有效期 72 小时、最多允许 30 次校验。 | 在项目页重新发起挑战，并把 DNS 记录（或文件）更新为新 token。 |
连接 MCP
Claude Code
最快的接入方式——在终端运行一条命令：
claude mcp add --transport http your-project https://invokera.com/r/your-project --header "Authorization: Bearer inv_YOUR_TOKEN"成功标志：在对话里问一句，能看到你的工具名即成功。
Claude Desktop
使用 streamable HTTP 端点和你的 endpoint token，把项目加入 claude_desktop_config.json：
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"your-project": {
"type": "http",
"url": "https://invokera.com/r/your-project",
"headers": { "Authorization": "Bearer inv_YOUR_TOKEN" }
}
}
}按你的操作系统修改对应文件，改完后重启 Claude Desktop 生效。
成功标志：在对话里问一句，能看到你的工具名即成功。
Cursor
在项目根目录创建 .cursor/mcp.json，JSON 形状相同：
{
"mcpServers": {
"your-project": {
"type": "http",
"url": "https://invokera.com/r/your-project",
"headers": { "Authorization": "Bearer inv_YOUR_TOKEN" }
}
}
}成功标志：在对话里问一句，能看到你的工具名即成功。
REST
没有 MCP 客户端？每个项目同时提供自描述的 REST 端点：
curl https://invokera.com/v1/your-project/tools -H "Authorization: Bearer inv_YOUR_TOKEN"自动化 / CI
用于脚本化管理项目的平台 API key（ik_）暂未开放自助签发。如需自动化或 CI 集成，请联系我们为你的账号开通。届时调用形如：
curl -X POST https://invokera.com/api/v1/projects -H "Authorization: Bearer ik_YOUR_API_KEY" -H "Content-Type: application/json" -d '{"specUrl":"https://api.example.com/openapi.json"}'常见问题
调用报错了——这些错误码是什么意思？
MCP 错误同时携带 JSON-RPC 错误码与 HTTP 状态码，高频的几个：
| 错误码 | 含义 | 处理办法 |
|---|---|---|
-32001 (HTTP 404) |
该 slug 下没有 MCP 端点——项目不存在或 URL 拼错了。 | 对照项目页核对端点 URL，slug 必须完全一致。 |
-32002 (HTTP 401) |
缺少或无效的 Bearer token。 | 请求需携带 Authorization: Bearer inv_… 项目 token；不确定就回控制台重新复制。 |
-32005 (HTTP 403) |
项目尚未发布——draft 项目即使持有效 token 也无法调用。 | 先完成域名验证并发布项目。 |
-32004 (HTTP 409) |
项目没有任何已启用的工具。 | 在控制台至少启用一个工具后重试。 |
-32003 (HTTP 403) |
该工具集已被平台封禁。 | 如认为是误判，请联系支持。 |
域名验证一直失败，该检查什么？
DNS TXT 记录生效需要传播时间——等几分钟后再检查。验证针对的是可注册域（eTLD+1），而不是子域名。如果你的 API 部署在托管平台的子域名上，请改用 .well-known 文件方式。
inv_ 和 ik_ 两种 token 有什么区别？
inv_ endpoint token 只能调用你已发布的工具；ik_ 平台 API key 用于管理你的账号和项目——绝不要交给智能体。
如何轮换 endpoint token？
在控制台打开项目并使用「轮换 token」。旧 token 会立即失效，请随后马上更新你的智能体配置。
token 抄丢了怎么办？
token 不会再次展示。在项目页使用"轮换 token"即可立刻拿到新 token，旧 token 同时失效——记得同步更新所有用到它的客户端。
Claude 已连接，却看不到任何工具？
通常是三种情况之一：项目没有已启用的工具（去控制台启用）；改完配置没有完全重启客户端（Claude Desktop 必须整个退出重开）；端点 URL 或 token 抄错——先用控制台的试跑功能排除服务端问题。