如何将已部署的 MCP 服务器发布到 Agentic MCP Gateway 并验证部署【免费下载链接】agenticYour API ⇒ Paid MCP. Instantly.项目地址: https://gitcode.com/GitHub_Trending/ag/agentic假设你已经把一个 MCP 服务器部署到了公网现在想通过 Agentic MCP Gateway 把它发布出去由 Agentic 的网关在你和客户端之间做代理统一处理认证、计费、限流、缓存与用量跟踪并让你的工具可直接被各主流 LLM SDK 和 MCP 客户端调用。本文按 Existing MCP Server 指南 的主路径操作安装 CLI → 登录 → 编写agentic.config→agentic deploy创建部署 → 验证 →agentic publish上线。前提条件开始之前确认以下几点均有文档依据本地已安装 Node.js指南前置要求。你的 MCP 服务器已部署到一个公网可访问的httpsURL并且支持Streamable HTTP传输。Agentic 目前只支持远程 origin 服务器不支持托管在 Agentic 基础设施上见 Origin Servers。你需要一个 Agentic 账号后面通过 CLI 登录或注册。安装 CLI 并登录安装agentic/cli。指南给出了四种包管理器主路径用 npmnpm i -g agentic/cli如果本地使用 pnpm、bun 或 yarn指南对应的命令分别是pnpm i -g agentic/cli bun install -g agentic/cli yarn global add agentic/cli登录。agenticCLI 默认使用 GitHub 认证agentic login也可以直接用邮箱和密码登录或者注册新账号agentic login -e email -p password # 或 agentic signup -e email -p password -u username其中email、password、username需要替换为你自己的账号信息。登录成功后可以用agentic whoami查看当前用户信息来确认登录状态见 CLI 命令说明。编写 agentic 项目配置在项目源码根目录添加一个agentic.config.ts或agentic.config.json文件。使用ts文件可以获得完整的自动补全和类型安全。TypeScript 方式先安装agentic/platform作为 dev 依赖npm i -save-dev agentic/platform然后在项目根目录创建agentic.config.tsimport { 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 } })JSON 方式创建agentic.config.json{ $schema: https://agentic.so/schema.json, name: Your Project Name, description: Your Project Description, origin: { type: mcp, url: Your Remote MCP Server URL } }模板中的尖括号占位符需要你替换为真实值项目名称、项目描述以及你已部署的远程 MCP 服务器 URL。origin.url必须是httpsURL 且该地址要能被 Agentic 的 MCP gateway 访问到。仓库中的 basic-mcp fixture 配置 是一个可直接参考的最小 MCP 项目配置各字段的完整说明见 Config Overview。创建部署agentic deploy在存放配置文件所在目录运行agentic deploy如果配置文件不在当前目录CLI 支持-c, --cwd dir参数指定读取配置的目录目录内必须包含agentic.config.{ts,js,json}之一见 CLI 命令说明。每次运行agentic deploy都会创建一个新的不可变 preview 部署。它不会影响任何已发布的产品直到你显式执行agentic publish。命令会输出一个部署 JSON 对象。指南给出的文档示例节选关键字段完整示例见原指南{ identifier: dev/search42ad78bf, hash: 42ad78bf, published: false, gatewayBaseUrl: https://gateway.agentic.so/dev/search42ad78bf, gatewayMcpUrl: https://gateway.agentic.so/dev/search42ad78bf/mcp, marketplaceUrl: https://agentic.so/marketplace/projects/dev/search, adminUrl: https://agentic.so/app/projects/dev/search/deployments/42ad78bf }该示例的tools、toolConfigs、pricingPlans、rateLimit等字段在原文档中更完整。注意两点返回的部署对象不会包含你的 origin 服务器信息因为部署到 Agentic MCP gateway 后 origin 被视为隐藏。记下adminUrl、gatewayMcpUrl和identifier下一步验证会用到。验证部署方式一在 Agentic 管理后台调用工具最简单的验证方式是访问部署返回的adminUrl格式为https://agentic.so/app/projects/your-project-identifier/deployments/hash。该页面会列出此部署的所有工具并提供一个 GUI展示如何用各种 MCP 客户端、TS/Python LLM SDK 以及简单 HTTP 调用它们也可以稍后用agentic get deploymentIdentifier查询某个部署的详细信息见 CLI 命令说明。方式二通过 HTTP 直接调用工具指南给出了一个针对 marketplace 上agentic/search项目search工具的文档示例你需要把项目标识符、工具名和工具参数替换为自己的curl -X POST -H Content-Type: application/json -d { query: example google search } https://gateway.agentic.com/mcp/search/search对应 HTTPie 写法http https://gateway.agentic.com/mcp/search/search queryexample google search换成你自己的部署时地址以agentic deploy返回的gatewayMcpUrl为准替换其中的项目标识符并把请求体换成目标工具的参数。另外注意如果调用方没有提供 API keyAgentic MCP Gateway 会默认按你项目的free定价计划处理该请求isCustomerSubscriptionActive为false并受free计划的限流约束见 Origin Metadata。发布部署agentic publishagentic deploy创建的只是 preview 部署。执行发布agentic publishCLI 默认发布当前目录下项目最近的部署也可以传入deploymentIdentifier参数来指定要发布的部署见 CLI 命令说明。CLI 会提示你确认一个semver版本号。如果目标部署已经发布过CLI 会报错并以非零状态退出。发布后项目会在https://agentic.so/marketplace/projects/your-project-identifier变为线上、公开可用的产品客户可以通过 Stripe 订阅你的产品你可以在 dashboard 中跟踪客户用量和收入。一个限制要提前知道已发布的产品虽然公开可访问但默认不会出现在 Agentic Marketplace 主页或搜索结果中beta 期间的策展策略需要单独联系官方提交。可选保护你的 origin MCP 服务器由于 origin 服务器部署在公网上且调用要经过 gateway 转发Agentic 的 MCP Gateway 在调用你的 origin 服务器时总是会携带一个proxy secretMCP origin 位于_meta.agentic.agenticProxySecret字段。该密钥可以在你 Agentic 项目的 dashboard 设置中找到。把该密钥配置为 origin 服务器的环境变量并在服务端校验可以确保只有来自 Agentic MCP Gateway 的调用被接受。文档给出的伪代码示例if ( (_meta?.agentic as any)?.agenticProxySecret ! process.env.AGENTIC_PROXY_SECRET ) { return { content: [ { type: text, text: Unauthorized } ], isError: true } }这一步仅当你的 origin 服务器部署在公网时有必要见 Origin Security。参考与后续完整步骤与示例输出Existing MCP Server 指南配置字段说明Config Overvieworigin 要求与元数据Origin Servers、Origin Metadata指南同时提到通过 GitHub 仓库在变更时自动部署项目的能力即将推出目前尚未开放。【免费下载链接】agenticYour API ⇒ Paid MCP. Instantly.项目地址: https://gitcode.com/GitHub_Trending/ag/agentic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考