企业官网建设流程全解析

Agentic 发布部署后如何用 cURL 通过 MCP Gateway HTTP 端点调用工具

【免费下载链接】agenticYour API ⇒ Paid MCP. Instantly.项目地址: https://gitcode.com/GitHub_Trending/ag/agentic

把一个 MCP server（或 OpenAPI service）部署到 Agentic 之后，你的工具不再被直接调用，而是经过 Agentic's MCP Gateway 转发。当你手边没有 MCP client 或 SDK，只想用一条 cURL 命令快速确认“部署出去的工具到底通不通”时，官方文档给出的路径是：运行agentic deploy拿到 gateway 地址，然后向 gateway 的 HTTP 端点POST工具参数。这篇文章覆盖从安装 CLI、写配置、部署，到用 cURL 调用工具和核对结果，操作步骤来自发布文档 Existing MCP Server。

前提

• 已安装 Node.js（文档标注的 Prerequisite）。
• 你的 origin server 已部署到公开可访问的httpsURL。MCP origin 要求该 URL 支持 Streamable HTTP transport 且能从 Agentic's MCP gateway 访问；OpenAPI origin 还需要提供 OpenAPI 3.x 的spec（本地文件、URL 或内嵌 JSON 字符串），不支持旧版 OpenAPI。字段细节见 Config Overview。

1. 安装 Agentic CLI 并登录

npm i -g @agentic/cli

也可以用 pnpm（pnpm i -g @agentic/cli）、bun（bun install -g @agentic/cli）或 yarn（yarn global add @agentic/cli）安装。

CLI 默认使用 GitHub 认证：

agentic login

或者用邮箱密码（<email>、<password>、<username>换成你自己的值）：

agentic login -e <email> -p <password> # 或注册 agentic signup -e <email> -p <password> -u <username>

2. 编写 agentic 配置

在项目的源码根目录创建agentic.config.ts（或agentic.config.json）。用ts文件可以获得完整自动补全和类型安全，需要先把@agentic/platform装为 dev 依赖：

npm i -save-dev @agentic/platform

import { defineConfig } from '@agentic/platform' export default defineConfig({ name: '<Your Project Name>', description: '<A brief description of your project>', origin: { type: 'mcp', url: '<Your Remote MCP Server URL>' } })

三个尖括号占位符都要替换成你自己的值：项目名、项目描述、你的远程 MCP server 公开 URL。也可以直接使用 JSON 格式的agentic.config.json，其中origin同样是type: "mcp"加url。两个与测试相关的默认行为（见 Config Overview）：

• 不配置pricingPlans时，默认只有一个 free plan，适合开发测试；
• 不配置defaultRateLimit时，使用平台默认值：每 customer 每分钟 1000 次请求。

3. 运行agentic deploy，拿到 gateway 地址

在配置文件所在目录执行：

agentic deploy

每次 deploy 都会创建一个新的不可变 preview deployment，它不会影响已发布的产品；要发布必须显式运行agentic publish。返回的 deployment 不包含 origin server 的任何信息——部署到 gateway 之后，origin 被视为隐藏。

文档示例的 deploy 输出（文档示例，字段值以你实际运行结果为准）包含这几个关键字段：

{ "id": "depl_kf4c3o8efh2y84dp5", "identifier": "@dev/search@42ad78bf", "hash": "42ad78bf", "published": false, "tools": [ { "name": "search", "inputSchema": { "required": ["query"] } } ], "gatewayBaseUrl": "https://gateway.agentic.so/@dev/search@42ad78bf", "gatewayMcpUrl": "https://gateway.agentic.so/@dev/search@42ad78bf/mcp", "marketplaceUrl": "https://agentic.so/marketplace/projects/@dev/search", "adminUrl": "https://agentic.so/app/projects/@dev/search/deployments/42ad78bf" }

对你有意义的是：

• tools数组列出每个工具的name和inputSchema——cURL 的参数就按这个 schema 写；
• gatewayBaseUrl/gatewayMcpUrl是这个 deployment 的 gateway 地址，其中gatewayMcpUrl（以/mcp结尾）是 MCP client 用的端点；
• adminUrl是验证结果要去的页面（见第 5 节）。

一处需要注意：deploy 输出示例里是gateway.agentic.so域名，而文档的 cURL 示例里是gateway.agentic.com，MCP client 文档中出现的也是gateway.agentic.so。文档没有解释两者关系，发起请求时以你自己 deploy 输出返回的地址和管理页展示的调用方式为准。

4. 用 cURL 调用工具

文档中的 cURL 示例调用@agentic/search项目的search工具，并明确说明：把项目标识、工具名和工具参数换成你自己的，其余调用方式不变：

curl -X POST -H "Content-Type: application/json" -d '{ "query": "example google search" }' https://gateway.agentic.com/mcp/search/search

对照你自己的 deployment 替换命令中的各部分：

两个边界：

• 认证：上面这条命令没有携带认证头。按 Origin Metadata，客户不提供 API key 时，gateway 会默认按项目的freepricing plan 处理（isCustomerSubscriptionActive为false），并套用freeplan 配置的 rate limits；Auth 说明正式用户是通过登录、经 Stripe 订阅后获得 API key，gateway 按 API key 追踪用量。
• 限流：未显式配置时，平台默认每 customer 每分钟 1000 次；pricing plan 级和 tool 级的 rate limit 可以覆盖这个默认值。

5. 验证结果

文档给出的测试方式是打开 deployment 的adminUrl（形如https://agentic.so/app/projects/<your-project-identifier>/deployments/<hash>，即 deploy 输出里的那个链接）。该页面列出这个 deployment 的所有可用工具，并提供 GUI 展示用各类 MCP client、TS/Python LLM SDK 以及 simple HTTP 调用的方式。

把它和 cURL 对照使用：gateway 会把工具调用转发到你的 origin server（Origin Metadata 说明 gateway 对所有发往 origin 的 tool call 都会附加_meta.agentic元数据或x-agentic-*头），响应内容由你自己 origin 工具的实现决定——文档没有给出固定的 cURL 响应体，所以具体输出以你的 origin 工具为准，可以用 admin 页 GUI 对同一参数调用做交叉核对。

6. 可选：发布产品

只做 preview deployment 测试到这里就够了。要让项目对所有 Agentic 用户公开、并允许客户通过 Stripe 订阅，运行：

agentic publish

CLI 会提示你确认一个semver版本。发布后项目立即成为 live、公开可用的产品，地址为https://agentic.so/marketplace/projects/<your-project-identifier>（<your-project-identifier>换成你 deploy 输出中的项目标识）。注意：已发布的产品默认不会出现在 Marketplace 主页或搜索中，需要单独联系官方提交。

限制

• MCP origin 的 URL 必须支持 Streamable HTTP transport，且可从 Agentic's MCP gateway 访问；
• OpenAPI origin 要求 OpenAPI 3.x spec，旧版本不受支持；
• 未认证调用只会按freeplan 运行并受其 rate limit 约束；
• MCP OAuth 与自定义 OAuth provider 目前处于 alpha 阶段，未默认公开启用（见 Auth）。

相关文档：Existing MCP Server、Existing OpenAPI Service、Config Overview、Auth、Origin Metadata。

【免费下载链接】agenticYour API ⇒ Paid MCP. Instantly.项目地址: https://gitcode.com/GitHub_Trending/ag/agentic