Celigo

Celigo AI

借助 AI，在 Celigo 平台上构建集成的一站式平台。

此仓库包含：

• 技能 -- 面向 AI 编码助手（Claude Code、Cursor、Codex，以及其他 50 多种）的领域知识
• MCP 提示词与资源 -- 由 Celigo MCP 服务提供的内容

安装技能

npx skills add celigo/ai

安装特定技能

# List available skills
npx skills add celigo/ai --list

# Install one skill
npx skills add celigo/ai --skill getting-started

# Install to a specific agent
npx skills add celigo/ai --skill configuring-exports -a claude-code

作为插件安装

此仓库也是 Claude Code、Cursor、Codex 和 Grok Build 的原生插件，其中打包了以下所有技能以及 Celigo Platform MCP 服务。

Claude Code -- 在应用中安装，或使用 claude CLI：

/plugin marketplace add celigo/ai
/plugin install celigo@celigo

Cursor -- 团队管理员可以直接在 Team Marketplaces 中添加此仓库。如需仅添加 MCP 服务，请使用连接 Celigo MCP 服务中的一键式 Add to Cursor 链接。

Codex -- 运行 codex plugin marketplace add celigo/ai，然后在 ChatGPT 桌面应用的 Plugins Directory 中安装 celigo。

Grok Build -- 直接从此仓库安装。--trust 可让插件的 MCP 服务运行：

grok plugin install celigo/ai --trust

对于其他 50 多种 Agent，请使用上文的安装技能方式。

安装插件也会配置 Celigo Platform MCP 服务。它通过 OAuth 进行身份验证——Agent 首次使用时，系统会提示你登录 Celigo，因此无需 API 令牌。

每个区域都有自己的身份提供方，因此只能在托管你账户的区域完成登录。除非选择其他区域，否则插件会连接到 US 端点（https://api.integrator.io/celigo-mcp）：

• Claude Code： 在插件提示时选择 Celigo region，或稍后通过 /plugin configure celigo@celigo 更改。从 CLI 安装时，可传入该选项：claude plugin install celigo@celigo --config api_host=api.eu.integrator.io。区域选择器需要 Claude Code 2.1.271 或更高版本。
• Cursor： 在 Cursor 控制面板的 Plugins -> Configure 下设置插件的 Celigo region（CELIGO_API_HOST），或设置 CELIGO_API_HOST 环境变量（例如 api.eu.integrator.io）；环境变量的优先级更高。
• Grok Build： 打开 /mcps，选择 Celigo（会显示 setup required），然后选择区域。在此之前服务不会启动，即使选择 US 也是如此。之后如需切换区域，可设置 CELIGO_API_HOST 环境变量（例如 api.eu.integrator.io）；环境变量的优先级更高。
• Codex： 插件始终使用 US 端点。对于 EU、AU 或 CA，请手动添加相应区域的服务——参阅 Codex CLI。

插件一次只能连接一个区域。如需使用多个区域的账户，请将每个其他区域作为独立服务添加，并使用不同的名称，例如 Celigo-EU。所有区域的端点请参阅区域。

使用 Claude（claude.ai、Desktop 或移动端）？所有区域都可以在 Claude 的连接器目录中找到 Celigo：添加到 Claude，然后选择 Connect 并选择相应区域的 URL。

使用其他客户端——VS Code、Windsurf、Gemini CLI、Codex CLI 或 Claude Desktop 的配置文件？请参阅**连接 Celigo MCP 服务**，其中提供一键式 Add to Claude、Add to Cursor 和 Install in VS Code 链接，以及可复制粘贴的配置。

技能

Skill 操作指南展示了 celigo CLI 命令，但大多数操作都可直接映射到捆绑的 Celigo Platform MCP 服务工具（list_* / upsert_* / delete_resource / run_flow / deploy_template），因此通过 MCP 连接的 Agent 可以遵循相同的技能，并转换命令块。少数管理界面（本地账户索引、堆栈、本地部署的 Agent、用户）仍然只能通过 CLI/REST/UI 操作，API 令牌则只能在 UI 中管理。

技能	描述
getting-started	核心概念、构建顺序、账户发现，以及应使用哪项技能
configuring-connections	凭据、身份验证方法、OAuth、iClients
configuring-exports	数据源步骤——REST、SOAP、数据库、文件、webhook、增量导出
configuring-imports	数据目标步骤——映射、查找、upsert 逻辑
building-flows	将导出连接到导入的管道——计划安排、链式调用、错误管理
building-syncs	Data Ingestion 同步——将应用程序表复制到数据仓库，并处理回填和架构漂移
building-apis	用于同步外部访问的自定义 HTTP 端点
building-tools	可供工作流、API、Agent 和 MCP 服务调用的可复用操作
building-mcp-servers	将工具提供给外部 AI Agent 的 MCP 端点
building-b2b	EDI 集成——交易伙伴、X12/EDIFACT、文件定义
configuring-ai-agents	在任意受支持的模型提供商上使用大模型驱动的导入步骤
configuring-filters	导出、导入和分支上的表达式与脚本过滤器
configuring-guardrails	PII 检测、内容审核、基于 AI 的验证
configuring-lookup-caches	用于快速查找和去重的内存键值存储
configuring-topics	Event Streams 主题——发布一次，在多个工作流中消费；保留策略、消息、监听器位置
managing-users	工作区用户——邀请、权限、MFA/SSO、访问级别
managing-end-users	MCP 终端用户、组、角色和能力授权
managing-integrations	跨环境的集成容器、克隆和生命周期管理（ILM）
managing-file-storage	Celigo Storage 文件和文件夹、Storage Query，以及供合作伙伴使用的托管 SFTP 服务
managing-api-tokens	入站 API 令牌——范围设定、轮换、撤销/删除生命周期
managing-network-policies	API 令牌、MCP 服务和登录的 IP 允许列表与拒绝列表
managing-stacks	用于钩子和连接器包装器的自带计算资源（服务器或 AWS Lambda）
managing-on-premise-agents	安全连接防火墙后的私有系统
using-marketplace-templates	安装模板和集成应用；复制预构建工作流
troubleshooting-flows	诊断故障、部分错误、卡住的作业和空运行
writing-mappings	Mapper 2.0、Transformation 2.0、查找、响应映射
writing-handlebars	用于映射、URI、SQL、过滤器的动态模板表达式
writing-settings-forms	设置表单，用于收集集成、流程组、工作流、导出、导入、连接和 iClients 的设置
writing-scripts	JavaScript 钩子——preSavePage、preMap、postMap、postSubmit
writing-sql	用于 Snowflake、Postgres、MySQL 等 RDBMS 导出/导入的 SQL

选择 CLI 或 MCP 服务

两者都可以访问同一个 integrator.io 账户，大多数技能都适用于两者：

• Celigo Platform MCP 服务无需安装：Claude、Cursor 和 VS Code 等聊天客户端使用 OAuth 登录并调用其工具。它涵盖日常构建和修复流程——连接、导出、导入、流程、集成、脚本、API、工具、AI Agent、护栏、查找缓存、MCP 服务、EDI 配置文件、文件定义、Celigo Storage 文件、模板和用户，还可以运行流程并读取和分类其错误及执行日志。
• Celigo CLI 适用于使用 shell 的 Agent。它提供本地文件树工作流（celigo pull、diff、push、promote、lint）、账户索引（celigo account snapshot|search|dependencies|lint），以及已部署的 MCP 服务没有工具支持的所有领域。

目前，已部署的 MCP 服务没有用于同步、Event Streams 主题、网络策略、终端用户及其组和角色、Storage Query 和托管 SFTP 文件服务、堆栈、本地部署的 Agent、流程、工具和 API 的测试运行、集成和流程克隆、集成修订和快照、连接 ping 和调试日志、导出和导入调用、处理器运行（Handlebars、筛选器、文件解析器）、通知、长运行时间警报、事件报告，以及除 Celigo Storage 文件之外的回收站还原和清空操作的工具。对于这些操作，请使用 CLI、integrator.io REST API 或 UI；API 令牌只能在 UI 中管理。如果某项技能包含 references/mcp.md，其中会说明 MCP 服务对该技能能做什么和不能做什么。

斜杠命令

该插件为 Cursor 和 Claude Code 提供了斜杠命令——由技能支持的辅助工具。创作类命令无需连接账户即可使用；如果连接了 CLI 或 MCP 服务，/celigo-troubleshoot 会通过其读取账户信息：

命令	描述
/celigo-plan-integration	根据需求规划新集成（设计 + 构建顺序）
/celigo-handlebars	编写或调试 Handlebars 表达式
/celigo-sql	为 RDBMS 导出/导入编写 SQL
/celigo-mapping	构建字段映射（Mapper 2.0）
/celigo-review-config	根据最佳实践审查粘贴的资源配置
/celigo-troubleshoot	诊断失败、不完整、为空或卡住的流程，并指出需要修复的内容（在你提出要求前仅限只读）

MCP 提示词和资源

mcp/ 目录包含由 Celigo MCP 服务通过 MCP 协议的 prompts/list、prompts/get、resources/list 和 resources/read 端点提供的提示词和资源，以及服务的 instructions。较新的服务版本还会通过 get_skill 工具，以 skill://celigo/<name>/<path> 的形式提供技能；已部署的服务仅提供提示词和资源——参见 mcp/README.md。

提示词

提示词	描述
getting-started	Celigo MCP 服务入门指南——核心概念、构建顺序、工具清单
plan-new-integration	根据需求规划新集成
review-flow-config	审查现有流程配置
troubleshoot-flow	诊断失败或运行异常的流程
diagnose-connection	排查连接问题
audit-account-health	审计账户运行状况并查找问题
writing-handlebars	编写 Handlebars 模板表达式
writing-sql	为 RDBMS 导出和导入编写 SQL

资源

资源	URI
账户架构模型	celigo://resources/account-architecture
账户设置参考	celigo://resources/account-settings
API 参考	celigo://resources/api-reference
连接器目录	celigo://resources/connector-catalog
错误模式	celigo://resources/error-patterns
术语表	celigo://resources/glossary
Handlebars 辅助函数目录	celigo://resources/handlebars-helpers
回收站参考	celigo://resources/recycle-bin
工具使用指南	celigo://resources/tool-usage-guide

添加 MCP 内容

请参阅 MCP README，了解 frontmatter 架构以及 Celigo MCP 服务如何使用这些文件。

Celigo CLI

这些技能在示例中会引用 Celigo CLI。使用以下命令安装：

npm install -g celigo-cli

适用时也会注明 API 和 UI 的替代方案。

链接

• Celigo 文档
• Celigo 开发者指南
• Agent 技能规范
• 技能目录

许可证

MIT