ouro
← Проекты

ОБЩИЙ MCP-КОНТРАКТ · ПОДКЛЮЧЕНИЕ

Подключить агента к Ouro

Cursor, Claude Code и Claude Desktop подключаются к локальному Ouro через stdio bridge. Выберите нужный клиент в проекте: Ouro подготовит JSON с точным адресом проекта и путём к файлу ключа. ChatGPT подключается отдельно через Secure MCP Tunnel.

Сначала запустите Ouro на своём компьютере. Затем откройте http://127.0.0.1:3000/projects или порт из строки Local вашего терминала. 127.0.0.1 обозначает устройство, на котором работает клиент; адрес из облачной среды сам по себе не открывает удалённый Ouro.

Сначала в Ouro

  1. Добавьте папку и откройте дашборд проекта. В «Назначить работу агенту» выберите MCP-клиент и нажмите «Зарегистрировать агента».
  2. Сохраните одноразовый ключ в отдельный локальный файл вне репозитория. В «Файл ключа агента» укажите его абсолютный путь. Ключ не нужно вставлять в JSON, URL или аргументы команды.
  3. Скопируйте конфигурацию либо скачайте JSON. Если настройки клиента уже существуют, добавьте только запись Ouro в mcpServers, сохранив остальные серверы. Node.js, bridge и файл ключа должны существовать по указанным абсолютным путям в среде запуска клиента.
  4. Для одновременной работы Cursor и Claude создайте отдельные регистрации и файлы ключей. Их действия и отзыв доступа будут различаться в дашборде.

Ключ Ouro даёт доступ к назначенной работе в одном проекте. Аккаунт, подписка или API-ключ клиента настраиваются в самом Cursor или Claude отдельно. Сохранение конфигурации не означает, что клиент уже подключился или модель начала работу.

Cursor

  1. Выберите Cursor в панели подключения и получите конфигурацию.
  2. Добавьте её в .cursor/mcp.json папки, открытой в Cursor. Для всех проектов можно использовать ~/.cursor/mcp.json. Конфигурация содержит mcpServers, а запись Ouro — type: stdio, command, args и env.
  3. В Cursor откройте настройки MCP в Customize, включите сервер Ouro и проверьте Available Tools. Разрешайте вызовы инструментов в соответствии с настройками доверия клиента.
  4. В Agent попросите прочитать назначение через ouro.get_context. Если изменили JSON и инструменты ещё не появились, обновите подключение или перезапустите Cursor.

Для локального stdio-подключения отдельный туннель не нужен. Если Cursor выполняет MCP в удалённой среде или контейнере, пути к Node.js, bridge и ключу должны быть доступны именно там.

Официальная инструкция Cursor

Claude Code

  1. Выберите Claude Code в панели подключения. Скопируйте полный JSON в .mcp.json папки, из которой запускаете Claude Code; сохраните соседние записи mcpServers.
  2. Подтвердите доверие к проекту и разрешение MCP-сервера. Управление подключениями и их проверка доступны через /mcp; в терминале также доступны claude mcp list и claude mcp get ИМЯ_СЕРВЕРА.
  3. Можно использовать скачанный файл отдельно: claude --mcp-config "/абсолютный/путь/ouro-claude-code-mcp.json". Это сохраняет существующие настройки клиента.
  4. Для claude mcp add-json нужна одна server entry, а не весь объект mcpServers. В панели Ouro откройте «Одна server entry для Claude Code CLI» и используйте формат импорта из официальной инструкции.

По умолчанию add-json использует локальную конфигурацию пользователя для текущей папки. Общий проектный файл .mcp.json может требовать отдельного подтверждения перед запуском сервера.

Официальная инструкция Claude Code

Claude Desktop

  1. Выберите Claude Desktop и получите JSON с command, args и env.
  2. В Claude Desktop откройте Settings → Developer → Edit Config. Добавьте запись Ouro в claude_desktop_config.json, сохранив остальные подключения.
  3. Полностью закройте приложение и запустите его заново. Найдите Ouro в Connectors → Manage connectors и проверьте доступные инструменты.
  4. Откройте разговор с разрешённым подключением и попросите Claude вызвать ouro.get_context.

Обычный путь macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. Windows: %APPDATA%\Claude\claude_desktop_config.json. Если приложение использует другой путь, ориентируйтесь на Edit Config.

Официальная инструкция локальных MCP-серверов

ChatGPT

  1. Выберите ChatGPT в панели Ouro, сохраните ключ и получите stdio-конфигурацию этого проекта.
  2. Установите официальный tunnel-client и настройте Secure MCP Tunnel со stdio-профилем, командой, аргументами и переменными OURO_URL / OURO_AGENT_TOKEN_FILE из конфигурации.
  3. Подключите туннель в аккаунте ChatGPT по официальной инструкции. Доступ зависит от прав аккаунта и workspace. Ключ OpenAI для туннеля настраивается отдельно от ключа Ouro.
Secure MCP Tunnel

Connect and test в ChatGPT

Начать работу и видеть её ход

В проекте выберите регистрацию агента, введите цель и DoD, нажмите «Начать работу». Скопируйте задание для агента и передайте его в выбранном клиенте. Агент сначала читает ouro.get_context с executionId, затем отправляет ouro.confirm_started. До этого попытка остаётся в ожидании.

Попросите агента сообщать Action с evidence, вопросы, развилки и блокеры через инструменты Ouro. Стандартные сообщения обновят дашборд. Собственные файловые и shell-инструменты IDE не становятся автоматически событиями Ouro; агент должен явно сообщать выполненные действия.

Вопросы решает человек. Применение решения, разрешение продолжения, ACK, предъявление результата и человеческая приёмка DoD фиксируются отдельно. Файловые инструменты Ouro дают чтение назначенной папки; права редактора и терминала Cursor/Claude Code задаются самим клиентом.

Инструкции в репозитории: docs/agent-clients-guide.md, docs/chatgpt-guide.md и docs/project-workspace-guide.md.

Пошаговая инструкция и устранение проблем