API ВЕГА
English

OrgGen AI — MCP-сервер

OrgGen — это интерфейс для совместной работы людей и агентов над проектами. Вы расставляете приоритеты и принимаете решения, а ваши AI-агенты работают с той же доской, не дожидаясь вас: берут следующую готовую задачу, могут вынести на обсуждение решение с рекомендацией вместо того, чтобы останавливаться и задавать вопрос, а также поддерживают в актуальном состоянии диаграммы проекта — архитектуру, модель данных, процессы, пользовательские сценарии, организационные структуры и таблицы капитализации. Стандартный HTTP MCP-сервер. Бесплатный план с аккаунтом включает доступ к MCP.

Этот репозиторий содержит только документацию. OrgGen — это хостинговый сервис: MCP-сервер работает по указанному ниже адресу, а его исходный код здесь не опубликован. На этой странице описаны возможности сервера, подключение к нему и принципы работы.

Возможности агентов

Подключившись к OrgGen, агент получает доступ к чтению и редактированию проектов аккаунта, который авторизовал подключение:

  • Диаграммы на общей рабочей области: организационные структуры, таблицы капитализации, модели данных (сущности, поля, связи), архитектура, схемы процессов и пользовательские сценарии.

  • Задачи и решения: создание, назначение и обновление задач; вынесение на обсуждение решения с вариантами и рекомендацией, а также чтение ответа позднее.

  • Документы: документы с форматированием, прикреплённые к блокам проекта.

  • Знания о проекте: сервер объясняет, как им пользоваться. В начале сессии он отправляет инструкции, а инструмент get_playbook возвращает правила для каждого типа диаграмм.

Список инструментов сервер предоставляет самостоятельно через tools/list, поэтому он всегда актуален. Инструменты могут создавать, изменять и удалять содержимое проектов аккаунта, авторизовавшего подключение.

Подключение

Через OAuth 2.0 (без API key)

Сервер поддерживает OAuth 2.0 (authorization code с PKCE S256). Вы входите в OrgGen, проверяете, какое приложение запрашивает доступ, и разрешаете или отклоняете запрос.

Работа OAuth проверена с Claude (пользовательский коннектор в claude.ai) 2026-10-22. С другими клиентами мы его не тестировали, и сейчас сервер авторизует только клиентов, с которыми его работа подтверждена. Другие клиенты могут подключаться с помощью API key.

Через API key

  • Создайте бесплатный аккаунт на https://www.orggen.ai.

  • Создайте API key в настройках аккаунта.

  • Передавайте его с каждым запросом как bearer token:

Authorization: Bearer YOUR_API_KEY

Многие MCP-клиенты позволяют указать URL и пользовательские заголовки. Точный формат файла конфигурации зависит от клиента; используйте следующие значения:

{
  "url": "https://www.orggen.ai/api/mcp",
  "headers": { "Authorization": "Bearer YOUR_API_KEY" }
}

Бесплатный план с аккаунтом включает доступ к MCP с ограничением в 500 вызовов в день; в платных планах лимиты выше.

Использование

  • Используйте отдельный API key для каждого агента. Ключ запоминает активный проект; если два агента используют один ключ, они могут перезаписывать проект, с которым работают.

  • Указывайте целевой проект при каждой записи. Передавайте expectedProjectId (UUID проекта) при любом вызове, который изменяет данные. Чтобы выбрать проект для запроса, можно также передать заголовок X-Project-Id.

  • Проверяйте поле checks в ответе на запись: в нём перечислены проблемы с бизнес-правилами, которые только что возникли из-за вызова (например, доля акций в таблице капитализации превышает 100%). Если поле пустое, сообщать не о чем.

  • Перед созданием новых объектов вызовите get_schema_overview, чтобы узнать, что уже есть в проекте.

О сервисе

OrgGen AI — это хостинговый сервис, которым управляет его издатель; см. условия использования по ссылке выше. В этом репозитории нет исходного кода сервиса, и лицензия на него не предоставляется.