OMOS-MCP

Сервер MCP, позволяющий AI-агентам (Claude, ChatGPT, Cursor и др.) читать документы проектов на OMOS Shared Drive для ответа на вопросы — каждый ответ ссылается на исходный файл со ссылкой Google Drive.

Поддерживаемая структура Drive:

OMOS/
├── Project A/
│   ├── Project Overview/
│   ├── Timeline/
│   ├── Design/
│   │   ├── System Flow/
│   │   ├── DB/
│   │   └── API/
│   └── BRD/
└── Project B/ ...

Инструменты

Агент выполняет поиск в следующем порядке: фильтр Project Name → если не найдено, смотрит Project Overview и запрашивает подтверждение у пользователя → затем уточняет, относится ли вопрос к Timeline | BRD | Design (System Flow / DB / API) → если вопрос слишком общий, переспрашивает, чтобы сузить область (встроено в серверные инструкции).

Related MCP server: brkt-gdrive-mcp

Одноразовая настройка: Service Account

Сервер получает доступ к Drive через сервисный аккаунт (не нужно, чтобы все входили в систему):

1. Зайдите в console.cloud.google.com → создайте новый проект (или используйте существующий)

2. APIs & Services → Library → найдите Google Drive API → нажмите Enable

3. IAM & Admin → Service Accounts → Create Service Account → задайте имя, например omos-mcp → нажмите Create (шаг с ролью можно пропустить, никаких прав не требуется)

4. Зайдите в созданный сервисный аккаунт → вкладка Keys → Add Key → Create new key → JSON → файл ключа загрузится

5. Скопируйте email сервисного аккаунта (вид omos-mcp@<project>.iam.gserviceaccount.com) и предоставьте доступ к Shared Drive / папке OMOS этому email с правами Viewer

6. Найдите folder id корневой папки OMOS: откройте папку в браузере и посмотрите в URL https://drive.google.com/drive/folders/<это и есть id>

Переменные окружения

Запуск локально

Сначала установите uv (curl -LsSf https://astral.sh/uv/install.sh | sh)

1) Настройте .env (сервер загружает его автоматически из корня репозитория):

cp .env.example .env

Отредактируйте .env, вставив OMOS_ROOT_FOLDER_ID и путь к файлу ключа (например, поместите файл ключа в ./service-account.json — он уже добавлен в gitignore)

2) Подключение к Claude Code (stdio):

claude mcp add omos -- uv run --directory "/path/to/OMOS-MCP" omos-mcp

Claude Desktop / Cursor / Windsurf — укажите в конфигурации MCP:

{
  "mcpServers": {
    "omos": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/OMOS-MCP", "omos-mcp"]
    }
  }
}

3) Тестирование: спросите агента "Какие проекты есть в OMOS?" — он должен вернуть список проектов со ссылками

(Альтернатива) Запуск как HTTP-сервера локально: включите OMOS_AUTH_TOKEN в .env, затем

uv run omos-mcp-http

endpoint находится по адресу http://localhost:8000/mcp, подключение:

claude mcp add --transport http omos http://localhost:8000/mcp -H "Authorization: Bearer <OMOS_AUTH_TOKEN>"

Развёртывание как MCP-ссылки (Render)

1. Залейте этот репозиторий на GitHub (в нём уже есть Dockerfile + render.yaml)

2. Render → New → Blueprint → выберите этот репозиторий

3. Задайте переменные окружения в панели:

   • OMOS_ROOT_FOLDER_ID = folder id корневой папки OMOS

   • GOOGLE_SERVICE_ACCOUNT_JSON = содержимое JSON-ключа целиком (вставьте как есть)

   • OMOS_AUTH_TOKEN Render сгенерирует сам → скопируйте и раздайте команде

4. После развёртывания endpoint: https://<app>.onrender.com/mcp

Пользователи подключаются:

claude mcp add --transport http omos https://<app>.onrender.com/mcp \
  -H "Authorization: Bearer <OMOS_AUTH_TOKEN>"

Cursor / VS Code: укажите URL + заголовок Authorization: Bearer <token> в конфигурации MCP

Использование с Claude.ai / ChatGPT (веб) — OAuth

У веб-клиентов нет возможности вводить заголовок, поэтому требуется OAuth через провайдера, например WorkOS AuthKit (бесплатно до 1 млн пользователей):

1. Зарегистрируйтесь на workos.com → включите AuthKit → настройте способ входа + ограничьте доступ только для членов команды

2. Панель → Connect → Configuration → включите Client ID Metadata Document и Dynamic Client Registration

3. Добавьте Resource Indicator = https://<app>.onrender.com (без /mcp)

4. Добавьте на Render ещё 3 переменные: OAUTH_ISSUER = домен AuthKit, OAUTH_AUDIENCE = https://<app>.onrender.com, PUBLIC_URL = https://<app>.onrender.com

5. Пользователь: Claude.ai → Settings → Connectors → Add custom connector → укажите https://<app>.onrender.com/mcp → войдите через WorkOS

Режим OAuth и bearer token могут сосуществовать — веб использует OAuth, CLI всё ещё может использовать токен

Тестирование конвертеров

uv run python test_convert.py