Celigo AI
Удобное решение для построения интеграций на платформе Celigo с использованием ИИ.
Этот репозиторий содержит:
-
Skills — знания предметной области для AI-ассистентов по кодированию (Claude Code, Cursor, Codex, и ещё 50+)
-
MCP Prompts & Resources — материалы и ресурсы, обслуживаемые сервером Celigo MCP
Install Skills
npx skills add celigo/ai
Install specific skills
# 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
Install as a Plugin
Этот репозиторий также является нативной витриной плагинов для Claude Code и Cursor, объединяющей все перечисленные ниже навыки, а также сервер Celigo Platform MCP.
Claude Code — в приложении или с использованием CLI claude:
/plugin marketplace add celigo/ai
/plugin install celigo@celigo
Cursor — установите Celigo через Marketplace плагинов Cursor (Настройки → Плагины). Администраторы команды могут добавить этот репозиторий напрямую в Маркетплейс команд.
Codex — выполните codex plugin marketplace add celigo/ai, затем установите celigo через раздел Plugins Directory в настольном приложении ChatGPT.
Для ещё 50+ других агентов используйте вышеописанную установку навыков.
Установка плагина также настраивает Celigo Platform MCP server (https://api.integrator.io/celigo-mcp). Аутентификация осуществляется через OAuth — в первый раз, когда агент будет использовать его, вам предложат войти в Celigo, поэтому API-токен не требуется.
Плагин поставляется с US-эндпойнтом. Каждый регион имеет собственного идентификационного провайдера, поэтому если ваша учётная запись находится в EU, AU или CA, вход может не завершиться корректно — задайте эндпойнт региона вручную (https://api.eu.integrator.io/celigo-mcp, https://api.au.integrator.io/celigo-mcp, или https://api.ca.integrator.io/celigo-mcp). См. Regions.
Используете другой клиент — VS Code, Windsurf, Gemini CLI, Codex CLI или Claude Desktop? См. Connect the Celigo MCP server для готовых конфигураций копирования и кнопки Add to Cursor одним кликом.
Skills
Руководства по навыкам показывают команды CLI celigo, но большинство операций напрямую соответствует инструментам, входящим в комплект Celigo Platform MCP server (list_* / upsert_* / delete_resource / run_flow / deploy_template). Поэтому агенты, подключённые через MCP, следуют тем же навыкам и преобразуют блоки команд. Некоторые административные поверхности (локальный индекс учётной записи, API-токены, стеки, локальные агенты, пользователи) остаются доступными только через CLI/REST/UI.
| Навык | Описание |
|---|---|
| getting-started | Основные концепции, порядок сборки, обнаружение учётной записи и выбор навыка |
| configuring-connections | Учётные данные, методы аутентификации, OAuth, iClients |
| configuring-exports | Шаги источника данных — REST, SOAP, база данных, файл, вебхук, синхронная синхронизация изменений |
| configuring-imports | Шаги назначения данных — отображения, поиск, логика upsert |
| building-flows | Соединение пайплайнов экспорта и импорта — планирование, связывание, обработка ошибок |
| building-apis | Пользовательские HTTP-конечные точки для синхронного внешнего доступа |
| building-tools | Повторно используемые операции, вызываемые из потоков, API, агентов и серверов MCP |
| building-mcp-servers | Конечные точки MCP, предоставляющие инструменты внешним AI-агентам |
| building-b2b | EDI-интеграции — торговые партнёры, X12/EDIFACT, определения файлов |
| configuring-ai-agents | Шаги импорта на основе LLM (OpenAI, Gemini) и защитные рамки |
| configuring-filters | Фильтры по выражениям и скриптам на экспортe, импортe и ветвления |
| configuring-guardrails | Обнаружение PII, модерация контента, валидация на основе ИИ |
| configuring-lookup-caches | Хранилища ключ-значение в памяти для быстрого поиска и устранения дубликатов |
| managing-users | Приглашения пользователей, разрешения, MFA/SSO, уровни доступа |
| managing-integrations | Контейнеры интеграций, клонирование и управление жизненным циклом (ILM) в разных окружениях |
| managing-api-tokens | Входящие API-токены — область применения, ротация, жизненный цикл отзыва/удаления |
| managing-stacks | Собственная вычислительная мощность для хуков и обёрток коннекторов (сервер или AWS Lambda) |
| managing-on-premise-agents | Безопасное подключение к приватным системам за файрволом |
| using-marketplace-templates | Установка шаблонов и приложений интеграции; копирование готовых потоков |
| troubleshooting-flows | Диагностика сбоев, частичных ошибок, зависших задач и пустых запусков |
| writing-mappings | Mapper 2.0, Transformation 2.0, сопоставления, lookups, отображение ответов |
| writing-handlebars | Динамические выражения шаблонов для отображений, URI, SQL и фильтров |
| writing-scripts | хуки JavaScript — preSavePage, preMap, postMap, postSubmit |
| writing-sql | SQL для экспорта/импорта в RDBMS — Snowflake, Postgres, MySQL и другие |
Slash Commands
Плагин включает команды Slash для Cursor и Claude Code — помощники по созданию контента, работающие без подключения к учётной записи:
| Команда | Описание |
|---|---|
| /celigo-plan-integration | Планирование новой интеграции на основе требований (дизайн + порядок выполнения) |
| /celigo-handlebars | Создать или отладить выражение Handlebars |
| /celigo-sql | Написать SQL для экспорта/импорта в RDBMS |
| /celigo-mapping | Построить отображение полей (Mapper 2.0) |
| /celigo-review-config | Проверить вставленную конфигурацию ресурса на соответствие лучшим практикам |
MCP Prompts & Resources
Папка mcp/ содержит подсказки и ресурсы, предоставляемые сервером Celigo MCP через конечные точки протокола MCP: prompts/list, prompts/get, resources/list и resources/read.
Prompts
| Подсказка | Описание |
|---|---|
| getting-started | Ориентация по серверу Celigo MCP — базовые концепции, порядок сборки, перечень инструментов |
| plan-new-integration | Планирование новой интеграции по требованиям |
| review-flow-config | Проверка существующей конфигурации потока |
| troubleshoot-flow | Диагностика неработающего или некорректно работающего потока |
| diagnose-connection | Устранение проблем с соединением |
| audit-account-health | Аудит состояния учётной записи и выявление проблем |
| writing-handlebars | Написание выражений шаблонов Handlebars |
| writing-sql | Написание SQL для экспорта и импорта RDBMS |
Resources
| Ресурс | URI |
|---|---|
| Account Architecture Model | celigo://resources/account-architecture |
| Account Settings Reference | celigo://resources/account-settings |
| API Reference | celigo://resources/api-reference |
| Connector Catalog | celigo://resources/connector-catalog |
| Error Patterns | celigo://resources/error-patterns |
| Glossary | celigo://resources/glossary |
| Handlebars Helper Catalog | celigo://resources/handlebars-helpers |
| Recycle Bin Reference | celigo://resources/recycle-bin |
| Tool Usage Guide | celigo://resources/tool-usage-guide |
Adding MCP content
См. MCP README для схемы frontmatter и того, как сервер Celigo MCP потребляет эти файлы.
Celigo CLI
Навигационные навыки ссылаются на Celigo CLI в качестве примеров. Установите его командой:
npm install -g celigo-cli
API и UI-альтернативы указаны там, где это применимо.