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

Подключение YandexGPT к таблицам Coverse через MCP

YandexGPT умеет работать с вашими таблицами и документами Coverse. Подключение делается по адресу сервера в консоли Yandex AI Studio, писать код не нужно.

В отличие от GigaChat, которому нужен агент на Python, у Яндекса есть MCP Hub — раздел, куда можно добавить внешний MCP-сервер по ссылке, как коннектор в Claude или ChatGPT.

Что понадобится​

  1. Аккаунт Yandex Cloud с доступом к AI Studio.
  2. Токен доступа Coverse — создаётся в Coverse: Настройки → Автоматизация и API → создать токен.
  3. Роли в Yandex Cloud. Чтобы создать подключение, нужны роли serverless.mcpGateways.editor и iam.serviceAccounts.user. Чтобы агент обращался к внешнему серверу — дополнительно serverless.mcpGateways.invoker и serverless.mcpGateways.anonymousInvoker.

Подключение через интерфейс​

  1. В консоли AI Studio выберите каталог, где у вас есть нужные роли.

  2. Слева откройте Agent Atelier → MCP-серверы.

  3. Нажмите Создать MCP-сервер и выберите способ Внешний MCP-сервер.

  4. Задайте Имя сервера, например, coverse. Остальные поля — описание, метки, подсеть, логи, сервисный аккаунт, можно не заполнять. Нажмите Создать.

  5. В окне параметров подключения укажите:

    • URL — адрес сервера Coverse:

      https://mcp.app.coverse.team/mcp

    • Транспорт — выберите Streamable HTTP.

    • Тип авторизации — выберите Токен доступа и в блоке «Заголовок авторизации» укажите:

      • имя заголовка: Authorization
      • значение: Bearer ВАШ_ТОКЕН_COVERSE

  6. Нажмите Подключиться.

  7. В блоке Инструменты выберите инструменты Coverse, которые хотите дать агенту, и нажмите Сохранить.

После этого сервер Coverse появится в MCP Hub, и AI-агент сможет читать и заполнять ваши таблицы.

к сведению

Слово Bearer, пробел и затем сам токен — всё в одном значении заголовка. Токен берётся в Coverse в разделе Настройки → Автоматизация и API.

Подключение через API​

Если вы обращаетесь к модели из кода, внешний MCP-сервер указывается прямо в запросе через OpenAI-совместимый Responses API:

response = client.responses.create(
    model=f"gpt://{YANDEX_FOLDER_ID}/yandexgpt",
    input=[{"role": "user", "content": "Покажи мои таблицы в Coverse"}],
    tools=[
        {
            "type": "mcp",
            "server_label": "coverse",
            "server_url": "https://mcp.app.coverse.team/mcp",
        }
    ],
)

Токен доступа Coverse передаётся так же в заголовке Authorization запроса к серверу Coverse.

Права доступа​

Что именно сможет делать агент, определяет токен Coverse. Если выдать токену только чтение, агент не изменит данные.

к сведению

Подробнее о том, как ограничить права агента, в статье «Права доступа и безопасность».

Частые вопросы​

Нужен ли программист, чтобы подключить YandexGPT?​

Нет. Внешний MCP-сервер добавляется по адресу в консоли Yandex AI Studio, писать код не нужно. Через код подключение тоже возможно, если вы обращаетесь к модели из своего приложения.

Какие данные увидит YandexGPT?​

Только те таблицы и документы, которые разрешает токен доступа Coverse. Права задаются при создании токена в разделе «Настройки → Автоматизация и API». Если выдать токену только чтение, агент не сможет менять данные.

Чем это отличается от подключения GigaChat?​

YandexGPT подключается по адресу в интерфейсе, без кода. GigaChat подключается через отдельного агента на Python. Поэтому для YandexGPT разработчик не нужен.

Полезные ссылки​