企业官网建设流程全解析

如何将已部署的 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。指南给出了四种包管理器，主路径用 npm：

npm 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.ts：

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>' } })

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/search@42ad78bf", "hash": "42ad78bf", "published": false, "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、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 query='example google search'

换成你自己的部署时，地址以agentic deploy返回的gatewayMcpUrl为准，替换其中的项目标识符，并把请求体换成目标工具的参数。

另外注意：如果调用方没有提供 API key，Agentic MCP Gateway 会默认按你项目的free定价计划处理该请求（isCustomerSubscriptionActive为false），并受free计划的限流约束（见 Origin Metadata）。

发布部署（agentic publish）

agentic deploy创建的只是 preview 部署。执行发布：

agentic publish

• CLI 默认发布当前目录下项目最近的部署，也可以传入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 secret（MCP 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 Overview
• origin 要求与元数据：Origin Servers、Origin Metadata

指南同时提到，通过 GitHub 仓库在变更时自动部署项目的能力即将推出，目前尚未开放。

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