CogniCo MCP Server

MCP-сервер для доступа к записям, документам и поиску в CogniCo из AI-ассистентов: Claude Code, Claude Desktop и других MCP-совместимых клиентов.

Быстрый старт

1. Войдите в CogniCo

Откройте CogniCo в браузере и убедитесь, что можете войти в нужный аккаунт.

2. Подключите MCP-сервер к вашему AI-клиенту

Стандартная конфигурация, подходит для большинства клиентов:

{
  "mcpServers": {
    "cognico": {
      "type": "http",
      "url": "https://cognico.ru/api/mcp/"
    }
  }
}

Выберите ваш клиент:

Claude Code

Добавьте сервер (выполните в терминале, не внутри сессии Claude Code):
```
claude mcp add -t http cognico https://cognico.ru/api/mcp/
```
Для подключения только в текущем проекте добавьте -s project.
Запустите (или перезапустите) Claude Code, чтобы он подхватил новый сервер.
В сессии Claude Code введите /mcp.
Выберите cognico в списке и нажмите Authenticate — откроется браузер.
Войдите в CogniCo и подтвердите доступ.
Проверьте статус подключения повторно через /mcp.

подсказка

Если после авторизации в браузере redirect не сработал — скопируйте URL из адресной строки браузера и вставьте его в появившееся поле в Claude Code.

Claude Desktop

Откройте Settings → Connectors.
Нажмите Add Connector и введите URL: https://cognico.ru/api/mcp/
Откроется браузер — войдите в CogniCo и подтвердите доступ.
После redirect коннектор станет активным.

примечание

Remote MCP-серверы с OAuth подключаются через Settings → Connectors, а не через claude_desktop_config.json.

Cursor

Cursor Settings → MCP → Add new MCP Server — имя cognico, тип http, URL https://cognico.ru/api/mcp/. Или добавьте конфигурацию в .cursor/mcp.json.
Рядом с сервером появится индикатор Needs login — нажмите на него.
В открывшемся браузере войдите в CogniCo и подтвердите доступ.
Браузер перенаправит обратно в Cursor — нажмите Open Cursor, если будет предложено.

VS Code (Copilot)

Добавьте конфигурацию в .vscode/mcp.json, или выполните:
```
code --add-mcp '{"name":"cognico","type":"http","url":"https://cognico.ru/api/mcp/"}'
```
В файле mcp.json над записью сервера появится кнопка Auth (CodeLens) — нажмите её.
В открывшемся браузере войдите в CogniCo и подтвердите доступ.
Управлять доступом можно через Accounts → Manage Trusted MCP Servers.

Windsurf

Добавьте стандартную конфигурацию по документации Windsurf MCP.
При подключении к серверу откроется браузер — войдите в CogniCo и подтвердите доступ.

Cline

Добавьте URL https://cognico.ru/api/mcp/ через вкладку Remote Servers в Cline.
При первом подключении появится кнопка Authenticate — нажмите её.
В открывшемся браузере войдите в CogniCo и подтвердите доступ.
Сервер переподключится автоматически.

Codex

Добавьте сервер:

codex mcp add cognico --type http --url https://cognico.ru/api/mcp/

Запустите авторизацию:
```
codex mcp login cognico
```
В открывшемся браузере войдите в CogniCo и подтвердите доступ.

Gemini CLI

Добавьте стандартную конфигурацию по инструкции.
В сессии Gemini CLI выполните:
```
/mcp auth cognico
```
В открывшемся браузере войдите в CogniCo и подтвердите доступ.

3. Пройдите OAuth-авторизацию

Следуйте шагам авторизации для вашего клиента выше. В процессе OAuth:

вы входите в CogniCo или используете уже активную сессию;
выбираете аккаунт, если их несколько;
подтверждаете доступ MCP-клиента к данным аккаунта;
после редиректа клиент автоматически получает токен и сохраняет подключение.

к сведению

В некоторых клиентах (Claude Code, Codex, Gemini CLI) авторизацию необходимо запустить вручную — она не начинается автоматически при добавлении сервера. Подробности — в инструкции для вашего клиента выше.

4. Готово

Теперь можно общаться с ассистентом на естественном языке:

"Покажи последние записи"
"Что обсуждали на совещании 2 марта?"
"Найди записи про бюджет"

Возможности

Записи

Инструмент	Что делает
`list_recordings`	Список записей с фильтрацией по папке, сортировкой и пагинацией
`get_recording`	Подробная информация о записи по ID
`update_recording`	Переименовать запись или переместить в другую папку

Документы

Каждая запись содержит документы с разными ролями:

summary — краткое саммари
formatted_transcription — полный текст расшифровки
action_points — пункты действий

Инструмент	Что делает
`list_documents`	Список документов записи или папки
`get_document`	Метаданные документа
`get_document_content`	Текстовое содержимое документа (markdown)
`create_document`	Создать новый документ
`update_document`	Обновить имя или содержимое
`delete_document`	Удалить документ
`move_documents`	Переместить документы в папку

Папки

Инструмент	Что делает
`get_folder_tree`	Дерево папок аккаунта
`list_folders`	Список папок в директории
`create_folder`	Создать папку
`rename_folder`	Переименовать папку
`move_items`	Переместить записи и папки

Поиск

Инструмент	Когда использовать
`search_fulltext`	Точные фразы и ключевые слова — "найди где упоминали Иванова"
`search_semantic`	Поиск по смыслу — "о чём говорили про планы на следующий квартал"

Примеры использования

Узнать что обсуждали на записи:

Что обсуждали на записи 2368?

Ассистент загрузит список документов записи, найдёт саммари и покажет содержимое.

Поиск по всем записям:

Найди все записи где обсуждали бюджет на следующий год

Ассистент выполнит семантический поиск и покажет релевантные фрагменты.

Работа с папками:

Создай папку "Q1 2026" и перемести туда записи 2367 и 2368

Ассистент создаст папку и переместит указанные записи.

Создание заметки по записи:

Прочитай запись 2368 и создай документ с ключевыми решениями

Ассистент загрузит транскрипцию, проанализирует и создаст новый документ.

Быстрый старт​

1. Войдите в CogniCo​

2. Подключите MCP-сервер к вашему AI-клиенту​

3. Пройдите OAuth-авторизацию​

4. Готово​

Возможности​

Записи​

Документы​

Папки​

Поиск​

Примеры использования​