Перейти к содержимому

ДОКУМЕНТАЦИЯ

Клиенты OpenConnector: SDK, CLI, HTTP и MCP

Вызывайте runtime через TypeScript SDK, oo CLI, HTTP или MCP, начиная с публичного Action Hacker News.

Поддерживает OOMOL·

Исходный код проверен 2026-09-09. Примеры сверены с указанной ревизией исходного кода. Это не подтверждение проверки реального API сервиса; ваша версия может отличаться.

Когда использовать OpenConnector

Используйте OpenConnector, если ИИ-агенту нужно вызывать сторонние сервисы через авторизованные аккаунты или если вы хотите управлять учётными данными и политиками выполнения в собственной инфраструктуре.

Как начать

Выберите собственный или размещённый в OOMOL runtime, подключите аккаунт, найдите Action, изучите схему входных данных и разрешения. Затем выполните небольшой вызов только для чтения и проверьте результат.

Границы runtime и API

Этот домен содержит информацию о проекте и документацию, а не работающий API коннекторов или MCP-сервер. Отправляйте запросы в выбранный runtime. При самостоятельном размещении изучите /openapi.json и /docs этого runtime. Для подключения аккаунтов пользователей вашего SaaS-продукта следуйте отдельному руководству OOMOL по интеграции в продукт.

Руководство по интеграции в продукт ↗

Установка официального oo CLI

Установите oo по официальному руководству, затем используйте oo connector для поиска и вызова Actions. Настройте URL runtime, токен runtime и подключения аккаунтов для выбранного развёртывания.

Установка официального oo CLI ↗

Официальный TypeScript SDK

Установите @oomol-lab/connector из npm. Для собственного runtime используйте клиент OpenConnector; для размещённых личных аккаунтов и подключений пользователей SaaS следуйте руководствам OOMOL SDK.

npm
npm install @oomol-lab/connector
npm: @oomol-lab/connector ↗

Справочная спецификация OpenAPI runtime

Скачайте спецификацию, созданную из зафиксированной ревизии runtime. Перед использованием задайте в runtimeUrl адрес своего развёртывания. Схемы Actions конкретных сервисов доступны в каталоге этого runtime. Этот сайт не выполняет вызовы API.

Справочная спецификация OpenAPI runtime →Исходный код runtime· 72de05b ↗

TypeScript

Сначала установите @oomol-lab/connector. Этот пример вызывает работающий локальный экземпляр OpenConnector из Node.js.

TypeScript
import { OpenConnector } from "@oomol-lab/connector";

const connector = new OpenConnector({
  baseUrl: "http://localhost:3000",
  runtimeToken: process.env.OOMOL_CONNECT_RUNTIME_TOKEN,
});

const stories = await connector.hackernews.get_top_stories({});
console.log(stories);

CLI

Установите oo CLI и направьте команды connector на локальную среду выполнения. Если включена аутентификация, также потребуется токен среды выполнения.

CLI
oo connector login http://localhost:3000
oo connector search "Hacker News"
oo connector schema hackernews.get_top_stories
oo connector run hackernews --action get_top_stories --data '{}'

HTTP

Вызовите этот Action только для чтения без аутентификации провайдера в локальной среде. Если включена аутентификация среды выполнения, добавьте Bearer-токен.

HTTP
curl -s -X POST \
  http://localhost:3000/v1/actions/hackernews.get_top_stories \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

MCP

Укажите этот HTTP MCP-эндпоинт в совместимом хосте агента. Аутентификация клиентов и поддерживаемые инструменты описаны в руководстве по API среды выполнения.

MCP
http://localhost:3000/mcp

Как читать результат

Ответы HTTP runtime содержат success, message, data и meta. Проверяйте success и выходную схему Action, а не только HTTP-статус. Если метаданные содержат executionId, по нему можно найти журнал с замаскированными секретами. Ниже показан формат ответа, а не результат реального вызова API.

Пример формата ответа
{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

Если вызов не удался

  • При ошибке аутентификации проверьте адрес и тип учётных данных: административный доступ защищает /api, Bearer-токен runtime используется для /v1 и /mcp. API-ключ провайдера не заменяет токен runtime.
  • При отказе в доступе проверьте scopes Action, правила Actions и разрешения на подключения. Даже действительный токен может не иметь доступа к выбранному аккаунту.
  • Если результат пуст или ресурс отсутствует, проверьте аккаунт и его права на этот ресурс. Успешная авторизация не открывает все рабочие пространства, каналы и документы.
  • Изучите ошибку и журнал до повтора. Если Action изменяет данные провайдера, сначала проверьте, не завершилась ли операция; не повторяйте запрос вслепую.
Читать в Markdown