如何使用 agentic deploy 创建预览部署、再用 agentic publish 发布并检查市场页面【免费下载链接】agenticYour API ⇒ Paid MCP. Instantly.项目地址: https://gitcode.com/GitHub_Trending/ag/agentic如果你已经有一个可公网访问的远程 MCP 服务器想把它变成可以在 Agentic 上收费的 MCP 产品操作流程是用agentic deploy创建一个不可变的预览部署preview deployment在管理后台或 HTTP 请求中验证工具可用确认没问题后再用agentic publish正式发布最后到 Agentic Marketplace 页面检查你的项目。前提条件是已安装 Node.js你的远程 MCP 服务器部署在可公网访问的httpsURL 上并且该 URL 支持 Streamable HTTP transport。准备条件安装 CLI并登录CLI 默认使用 GitHub 认证也可以用邮箱密码npm i -g agentic/cli agentic login如果已有 Agentic 账号但没有 GitHub 登录习惯agentic login -e email -p password # 或注册新账号 agentic signup -e email -p password -u username上面的email、password、username替换为你自己的邮箱、密码和用户名。在项目源码根目录创建agentic.config.ts或agentic.config.json声明项目名、描述和 origin即你的 MCP 服务器地址。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 版配置等价适合不想引依赖的场景{ $schema: https://agentic.so/schema.json, name: Your Project Name, description: Your Project Description, origin: { type: mcp, url: Your Remote MCP Server URL } }Your Project Name、A brief description of your project、Your Remote MCP Server URL分别替换为你的项目名、项目描述和你的 MCP 服务器 URL。用 agentic deploy 创建预览部署在包含agentic.config.ts或.json的目录中运行agentic deployagentic deploy每次运行都会创建一个新的不可变预览部署。这些预览部署不会影响你已经发布的任何产品直到你运行agentic publish。两个常用选项来自 CLI 定义-c, --cwd dir当配置文件不在当前目录时指定加载 Agentic 项目配置的目录该目录必须包含agentic.config.{ts,js,json}-d, --debug只打印解析后的 agentic 配置并返回不实际创建部署适合部署前确认配置被正确解析。部署成功时 CLI 会打印部署详情 JSON。文档给出的示例输出示例结果字段值与你自己的项目不同{ id: depl_kf4c3o8efh2y84dp5iwsha95, identifier: dev/search42ad78bf, hash: 42ad78bf, published: false, description: Official Google Search tool. Useful for finding up-to-date news and information about any topic., 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工具名、描述、inputSchema、toolConfigs、pricingPlans等字段。两个需要留意的点published为false说明这是一个预览部署尚未对外发布返回的部署信息不会包含你 origin 服务器的任何信息因为 origin 在部署到 Agentic 的 MCP Gateway 后即被视为隐藏你的源服务器地址不会暴露给客户。记下输出中的identifier和各 URL后面验证和发布都会用到。验证预览部署文档推荐的最简单验证方式是在 Agentic 管理后台打开该部署对应的adminUrl格式为https://agentic.so/app/projects/your-project-identifier/deployments/hash这个页面会列出该部署的全部工具并提供 GUI演示如何分别用各种 MCP 客户端、TS LLM SDK、Python LLM SDK 和纯 HTTP 调用它们。也可以直接发 HTTP 请求测试某个工具。文档示例调用的是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 get deploymentIdentifier重新拉取该部署的详情或用agentic list [identifier]列出部署。用 agentic publish 发布确认预览部署没问题后运行agentic publishagentic publish默认发布目标目录中该项目最近一次创建的部署也可以传入一个 deployment identifier 作为参数明确指定要发布哪个部署。-c, --cwd dir选项同deploy用于配置文件不在当前目录的情况。CLI 会提示你确认一个semver版本。版本选项基于项目最近一次已发布版本从未发布过时以0.0.0为基线生成 patch / minor / major 三个递增候选选择其中一项即可。发布成功后 CLI 会输出类似下面的确认信息格式来自 CLI 实现Deployment identifier published with version version发布后你的项目就是一个线上、公开可访问的产品任何 Agentic 用户都能通过网关访问并可以通过 Stripe 订阅你的产品。客户用量和收入可以在 Agentic dashboardhttps://agentic.so/app跟踪。一个需要知道的失败场景如果你要发布的部署已经是 published 状态CLI 会报错例如Latest deployment identifier is already published并以非零状态码退出而不是重复发布。检查市场页面发布完成后你的项目会出现在https://agentic.so/marketplace/projects/your-project-identifier把your-project-identifier替换为你部署的identifier预览部署的marketplaceUrl字段已经给出了完整地址。打开这个页面确认项目信息、工具列表和价格展示是否符合预期这个 URL 也可以直接分享给客户。一个文档明确指出的边界发布后的产品虽然线上可用、可通过直接 URL 访问但默认不会出现在 Agentic Marketplace 主页和搜索结果中——这是 beta 期间为了保持市场内容质量而做的限制。如果你希望产品进入公开 Marketplace 的检索列表需要按文档说明联系 Agentic 团队提交。限制回顾预览部署不可变每次改动配置后运行agentic deploy都会产生一个新部署在运行agentic publish之前预览部署对客户不可见也不影响已发布产品。部署成功后 origin 服务器地址即被隐藏部署详情中看不到源服务器信息属预期行为。已发布的部署再次执行agentic publish会直接报错退出。发布不等于上架市场主页与搜索的可发现性需要另行向 Agentic 团队提交文档入口见 contact。完整流程参考文档Existing MCP Server 指南 和 CLI readme。【免费下载链接】agenticYour API ⇒ Paid MCP. Instantly.项目地址: https://gitcode.com/GitHub_Trending/ag/agentic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考