API

API управления для всей вашей инстанции

Всё, что делает дашборд, — в виде REST. Создавайте connector'ы, генерируйте инструменты, переключайте code mode, выпускайте ключи и запускайте File Search — из скрипта, CI-задачи или агента.

Быстрый старт
# a management key from the dashboard or `amcp login --browser`$ export AMCP_API_KEY=amk_live_xxx# the CLI resolves the base URL and auth for you$ amcp api GET /api/connectors$ amcp api POST /api/mcp-servers --data '{"name":"ops"}'# or call the HTTP API directly$ curl -H "Authorization: Bearer $AMCP_API_KEY" \  https://cloud.anythingmcp.com/api/connectors

Аутентификация

К API ведут два realm, и оба уважают вашу роль. Выберите тот, что подходит вызывающей стороне.

Сессия (JWT)

Авторизованные пользователи в дашборде. Настраивать нечего — сессию несёт браузер.

Ключ управления

Для скриптов и агентов. Выпустите ключ с scope в настройках или через `amcp login --browser` и отправляйте его как Bearer token.

scope — Ключ несёт scope — management-read или management-admin — и его реальная сила равна меньшему из scope ключа и роли владельца. Ключи агентов по умолчанию read-only.

Что можно вызывать

Более 200 операций, сгруппированных по ресурсам. Полную, всегда актуальную схему смотрите в интерактивном справочнике.

Connectors

/api/connectors

Создавайте connector'ы и импортируйте инструменты из OpenAPI, WSDL, GraphQL, Postman, cURL или HAR — либо обнаруживайте их с MCP server.

Tools

/api/connectors/:id/tools

Просматривайте, создавайте, обновляйте и удаляйте инструменты connector'а вместе с их входными схемами.

MCP servers

/api/mcp-servers

Создавайте server'ы, назначайте инструменты и роли, переключайте code mode между off, tools и inline.

Adapters

/api/adapters

Импортируйте из встроенного каталога готовых connector'ов по slug.

API keys

/api/mcp-keys

Выпускайте, просматривайте и отзывайте MCP- и management-scoped-ключи — self-service, привязаны к вашему аккаунту.

File Search

/api/file-search

Управляйте доступными для поиска space и папками, чтобы агенты извлекали данные из ваших документов.

Соглашения

Base URL

cloud.anythingmcp.com в Cloud или ваш собственный хост в self-hosted. CLI подставит его за вас.

Заголовок auth

Authorization: Bearer <key>. Тот же guard принимает и сессионный JWT.

Формат

JSON на вход, JSON на выход. Отправляйте тело через --data (CLI) или Content-Type: application/json (HTTP).

Ограничение по scope

Каждый запрос ограничен вашей организацией; ключ никогда не доберётся до данных другого tenant.

Rate limit

По умолчанию 300 запросов в минуту на ключ, настраивается оператором. 429 означает «сбавьте темп».

Ошибки

Стандартные коды HTTP; 401 — неверная или отсутствующая auth, 403 — слишком низкий scope или роль, 404 — не найдено.

Стройте на API

Получите ключ, откройте интерактивный справочник и скриптуйте свою инстанцию от начала до конца.