⚙️

Как подключить Глинку по MCP

MCP (Model Context Protocol) — способ дать ИИ-ассистенту инструменты. У Глинки есть свой MCP-сервер: после подключения ассистент читает и создаёт страницы, базы и строки в вашем пространстве, ищет по нему, оставляет комментарии, загружает картинки и публикует страницы — от вашего имени и с вашими правами.

Адрес и протокол

Сервер: https://glinka.app/api/mcp
Протокол: MCP Streamable HTTP. Отдельного SSE-потока сервер не отдаёт — клиенты, которым нужен только SSE, не подойдут.
Авторизация: личный токен. Передать его можно двумя способами: заголовком Authorization: Bearer <токен> (клиенты с настройкой заголовков, командная строка) или параметром в адресе — https://glinka.app/api/mcp?token=<токен> (клиенты, которые принимают только адрес, например коннектор в claude.ai).

Где взять токен

Откройте настройки пространства → Интеграции.
Создайте токен и сохраните его как пароль: он даёт те же права, что есть у вас в этом пространстве.
Токен привязан к одному пространству. Для второго пространства нужен второй токен.
Отозвать токен можно там же, в «Интеграциях». Отозванный токен перестаёт работать сразу во всех клиентах.

MCP доступен на платных тарифах и в пробном периоде командного пространства. На бесплатном тарифе вкладка «Интеграции» показывает, как перейти на тариф. Подробнее о том, что открывает токен и как с ним обращаться, — Токен MCP: создать, отозвать и что он открывает.

Настройка в клиентах

Проверено нами: Claude (claude.ai, Claude Desktop) и Claude Code. Остальные клиенты — по их документации; если у вас получилось, расскажите нам через «?» → «Оставить отзыв» в приложении.

Claude (claude.ai, Claude Desktop). Настройки → Коннекторы → добавить свой коннектор. В поле адреса вставьте https://glinka.app/api/mcp?token=<токен>, авторизацию не настраивайте — токен уже в адресе. Свои коннекторы доступны на платных тарифах Claude.

Claude Code. Одна команда в терминале:

claude mcp add --transport http glinka https://glinka.app/api/mcp --header "Authorization: Bearer <токен>"

Cursor. Файл ~/.cursor/mcp.json (для всех проектов) или .cursor/mcp.json (для одного):

{
  "mcpServers": {
    "glinka": {
      "url": "https://glinka.app/api/mcp",
      "headers": { "Authorization": "Bearer <токен>" }
    }
  }
}

Codex (командная строка и расширение VS Code). Файл ~/.codex/config.toml:

[mcp_servers.glinka]
url = "https://glinka.app/api/mcp"
bearer_token_env_var = "GLINKA_MCP_TOKEN"

и переменная окружения GLINKA_MCP_TOKEN=<токен>.

VS Code с Copilot, Windsurf, Gemini CLI, агенты в Yandex AI Studio тоже подключают удалённые MCP-серверы по HTTP: нужны адрес сервера и токен, остальное — по документации клиента.

Что умеет ассистент через MCP

Страницы: список и поиск по пространству, чтение, создание, дополнение и замена текста с проверкой версии, перенос, дублирование, корзина.
Базы: создание со схемой, колонки, строки — создать, изменить, прочитать, запросить с фильтрами и сортировкой; у строки есть своя страница.
Представления: доска, список, календарь, диаграмма, галерея — создать и настроить фильтры, сортировки и итоги.
Комментарии: читать ветки, оставлять комментарии и отвечать в ветке.
Картинки: загружать в страницу и заменять.
Публикация и доступ: включать и проверять публикацию, читать и задавать права на страницу. Сбросить ссылку можно только в приложении.

Все 36 инструментов по одному, с ограничениями, — Инструменты MCP: что умеет ассистент. Страницы и строки, созданные ассистентом, помечаются как созданные через MCP.

Безопасность

Токен — это ваши права. Не вставляйте его в чужие инструменты и общие чаты.
Ассистент видит то же, что и вы: всё пространство с учётом прав доступа к страницам.
Если токен утёк — отзовите его в «Интеграциях» и создайте новый.

Дальше: Установочный промпт: общая память для ИИ-агентов — как заставить несколько агентов пользоваться одной памятью в Глинке.