teletype-mcp-server 0.1.0 → 0.1.1

package/docs/ru/CLIENTS.md

@@ -4,6 +4,8 @@
 
 Для подключения к хостед-серверу `https://mcp.teletype.app/mcp` нужен Public API токен Teletype. Ниже есть примеры для хостед-сервера и локального запуска при самостоятельном размещении, работе в изолированном контуре или офлайн-eval. Перед запуском клиента, который читает токен из окружения, задайте `TELETYPE_API_TOKEN`. В примерах с `your-teletype-public-api-token` замените заглушку в личном конфиге.
 
+Раскройте блок «Показать конфиг» под инструкцией нужного клиента и скопируйте содержимое. Ссылка на отдельный файл есть внутри блока.
+
 ## Codex
 
 Для хостед-эндпоинта добавьте его в `~/.codex/config.toml`. Настройка `env_http_headers` берёт значение заголовка из окружения:
@@ -14,9 +16,23 @@ url = "https://mcp.teletype.app/mcp"
 env_http_headers = { "X-Teletype-Api-Token" = "TELETYPE_API_TOKEN" }
 ```
 
-Для локального сервера добавьте в тот же файл [этот блок](../../examples/clients/codex.toml). Остальные настройки файла сохраните. Перезапустите Codex и проверьте конфигурацию командой `codex mcp list`. Параметр `env_vars` передаст токен из окружения процессу сервера.
+Для локального сервера добавьте в тот же файл блок ниже. Остальные настройки файла сохраните. Перезапустите Codex и проверьте конфигурацию командой `codex mcp list`. Параметр `env_vars` передаст токен из окружения процессу сервера.
+
+<details>
+<summary>Показать конфиг (codex.toml)</summary>
+
+```toml
+[mcp_servers.teletype]
+command = "npx"
+args = ["-y", "teletype-mcp-server", "--stdio"]
+env_vars = ["TELETYPE_API_TOKEN"]
+```
+
+Отдельный файл: [codex.toml](../../examples/clients/codex.toml).
 
-Для установки плагина выполните `codex plugin marketplace add Teletype-App/teletype-mcp-server`, затем откройте `/plugins` в Codex, установите `teletype` и начните новую сессию. Плагин объединяет сервер и скилл. Подробности в [разделе про плагины](../../README-ru.md#плагины-для-claude-code-и-codex).
+</details>
+
+Для установки плагина выполните `codex plugin marketplace add Teletype-App/teletype-mcp-server`, затем откройте `/plugins` в Codex, установите `teletype` и начните новую сессию. Плагин объединяет сервер и скилл. Подробности в [разделе про плагины](../../README-ru.md#плагины-для-claude-code-codex-и-cursor).
 
 Без плагинов Codex читает скиллы [Agent Skills](https://agentskills.io) из `~/.agents/skills` (пользовательский уровень) или из `.agents/skills` в репозитории. npm-пакет поставляет скилл `teletype-support` с регламентами поддержки. Для установки выполните:
 
@@ -27,55 +43,424 @@ cp -r node_modules/teletype-mcp-server/plugin/skills/teletype-support ~/.agents/
 
 ## Claude Code
 
-Для хостед-эндпоинта добавьте в `.mcp.json` содержимое [этого файла](../../examples/clients/claude-code-remote.json) или выполните `claude mcp add --transport http teletype https://mcp.teletype.app/mcp --header "X-Teletype-Api-Token: $TELETYPE_API_TOKEN"`. Плагин ниже уже настроен на хостед-сервер.
+Для хостед-эндпоинта добавьте в `.mcp.json` содержимое конфига ниже или выполните `claude mcp add --transport http teletype https://mcp.teletype.app/mcp --header "X-Teletype-Api-Token: $TELETYPE_API_TOKEN"`. Плагин ниже уже настроен на хостед-сервер.
+
+<details>
+<summary>Показать конфиг (claude-code-remote.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "type": "http",
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": { "X-Teletype-Api-Token": "${TELETYPE_API_TOKEN}" }
+    }
+  }
+}
+```
+
+Отдельный файл: [claude-code-remote.json](../../examples/clients/claude-code-remote.json).
+
+</details>
 
-Для локального запуска скопируйте [этот файл](../../examples/clients/claude-code.json) в `.mcp.json` своего проекта. Claude Code подставит `${TELETYPE_API_TOKEN}` из окружения. Запустите клиент в проекте и проверьте подключение через `/mcp` или `claude mcp list`.
+Для локального запуска скопируйте конфиг ниже в `.mcp.json` своего проекта. Claude Code подставит `${TELETYPE_API_TOKEN}` из окружения. Запустите клиент в проекте и проверьте подключение через `/mcp` или `claude mcp list`.
+
+<details>
+<summary>Показать конфиг (claude-code.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "command": "npx",
+      "args": ["-y", "teletype-mcp-server", "--stdio"],
+      "env": { "TELETYPE_API_TOKEN": "${TELETYPE_API_TOKEN}" }
+    }
+  }
+}
+```
 
-Для установки плагина с сервером, скиллом и командами выполните `/plugin marketplace add Teletype-App/teletype-mcp-server`, затем `/plugin install teletype@teletype-mcp-server`. Подробности в [разделе про плагины](../../README-ru.md#плагины-для-claude-code-и-codex).
+Отдельный файл: [claude-code.json](../../examples/clients/claude-code.json).
+
+</details>
+
+Для установки плагина с сервером, скиллом и командами выполните `/plugin marketplace add Teletype-App/teletype-mcp-server`, затем `/plugin install teletype@teletype-mcp-server`. Подробности в [разделе про плагины](../../README-ru.md#плагины-для-claude-code-codex-и-cursor).
+
+При включении плагина введите токен в секретное поле **Teletype Public API token**. Плагин использует `userConfig`, а не переменную окружения. Прямое подключение через `.mcp.json` выше по-прежнему поддерживает переменную окружения.
 
 ## OpenCode
 
-Скопируйте [этот файл](../../examples/clients/opencode.json) в `opencode.json` своего проекта. OpenCode возьмёт токен из `{env:TELETYPE_API_TOKEN}`. Проверьте подключение командой `opencode mcp list`. Настройка `auto` использует версию протокола 2026, если клиент и сервер её согласуют, и версию 2025 в остальных случаях.
+Скопируйте конфиг ниже в `opencode.json` своего проекта. OpenCode возьмёт токен из `{env:TELETYPE_API_TOKEN}`. Проверьте подключение командой `opencode mcp list`. Настройка `auto` использует версию протокола 2026, если клиент и сервер её согласуют, и версию 2025 в остальных случаях.
+
+<details>
+<summary>Показать конфиг (opencode.json)</summary>
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "servers": {
+      "teletype": {
+        "type": "local",
+        "command": ["npx", "-y", "teletype-mcp-server", "--stdio"],
+        "environment": { "TELETYPE_API_TOKEN": "{env:TELETYPE_API_TOKEN}" },
+        "protocol": "auto",
+        "codemode": false
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [opencode.json](../../examples/clients/opencode.json).
+
+</details>
 
 ## MiniMax Code
 
-Скопируйте [этот конфиг](../../examples/clients/mcode.json) в `.mcp.json` проекта, где запускаете `mcode`. Если файл уже есть, добавьте запись `teletype` в существующий объект `mcpServers`. Перед запуском MiniMax Code задайте `TELETYPE_API_TOKEN` в том же терминале. Конфиг подключает хостед MCP-сервер Teletype. Проверьте подключение через `/mcp`, затем попросите найти неотвеченные диалоги Teletype и убедитесь, что агент вызвал `find_conversations`. MiniMax Code читает `.mcp.json` из корня проекта. Подробности есть в [его инструкции по MCP](https://github.com/MiniMax-AI/minimax-code/blob/main/docs/examples.md#5-connect-an-authenticated-project-mcp-server).
+Скопируйте конфиг ниже в `.mcp.json` проекта, где запускаете `mcode`. Если файл уже есть, добавьте запись `teletype` в существующий объект `mcpServers`. Перед запуском MiniMax Code задайте `TELETYPE_API_TOKEN` в том же терминале. Конфиг подключает хостед MCP-сервер Teletype. Проверьте подключение через `/mcp`, затем попросите найти неотвеченные диалоги Teletype и убедитесь, что агент вызвал `find_conversations`. MiniMax Code читает `.mcp.json` из корня проекта. Подробности есть в [его инструкции по MCP](https://github.com/MiniMax-AI/minimax-code/blob/main/docs/examples.md#5-connect-an-authenticated-project-mcp-server).
+
+<details>
+<summary>Показать конфиг (mcode.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "type": "http",
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "${TELETYPE_API_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [mcode.json](../../examples/clients/mcode.json).
+
+</details>
 
 ## Cursor
 
-Добавьте запись из [этого конфига](../../examples/clients/cursor.json) в `~/.cursor/mcp.json` или `.cursor/mcp.json` проекта. Cursor подставит `${env:TELETYPE_API_TOKEN}` в HTTP-заголовок. Сделайте токен доступным процессу Cursor, перезапустите клиент и проверьте сервер в **Customize → MCPs**. См. [документацию Cursor MCP](https://prod.cursor.com/docs/mcp).
+Добавьте запись из конфига ниже в `~/.cursor/mcp.json` или `.cursor/mcp.json` проекта. Cursor подставит `${env:TELETYPE_API_TOKEN}` в HTTP-заголовок. Сделайте токен доступным процессу Cursor, перезапустите клиент и проверьте сервер в **Customize → MCPs**. См. [документацию Cursor MCP](https://prod.cursor.com/docs/mcp).
+
+<details>
+<summary>Показать конфиг (cursor.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "${env:TELETYPE_API_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [cursor.json](../../examples/clients/cursor.json).
+
+</details>
+
+В маркетплейс-версии плагина токен задаётся через **Plugins → Configure** как `TELETYPE_API_TOKEN`. Нативный манифест Cursor объявляет эту переменную и подключает хостед-сервер. Подробности в [README плагина](../../plugin/README.md).
 
 ## VS Code с GitHub Copilot
 
-Добавьте [этот конфиг](../../examples/clients/vscode.json) в `.vscode/mcp.json` проекта или пользовательский MCP-конфиг VS Code. VS Code запросит Public API токен и сохранит его как секретный ввод. Проверьте подключение командой **MCP: List Servers**. Формат `.vscode/mcp.json` использует `servers` и отличается от формата `mcpServers` в Copilot CLI. См. [документацию VS Code MCP](https://code.visualstudio.com/docs/agents/reference/mcp-configuration).
+Добавьте конфиг ниже в `.vscode/mcp.json` проекта или пользовательский MCP-конфиг VS Code. VS Code запросит Public API токен и сохранит его как секретный ввод. Проверьте подключение командой **MCP: List Servers**. Формат `.vscode/mcp.json` использует `servers` и отличается от формата `mcpServers` в Copilot CLI. См. [документацию VS Code MCP](https://code.visualstudio.com/docs/agents/reference/mcp-configuration).
+
+<details>
+<summary>Показать конфиг (vscode.json)</summary>
+
+```json
+{
+  "inputs": [
+    {
+      "type": "promptString",
+      "id": "teletype-api-token",
+      "description": "Teletype Public API token",
+      "password": true
+    }
+  ],
+  "servers": {
+    "teletype": {
+      "type": "http",
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "${input:teletype-api-token}"
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [vscode.json](../../examples/clients/vscode.json).
+
+</details>
 
 ## GitHub Copilot CLI
 
-Добавьте [этот конфиг](../../examples/clients/copilot-cli.json) в личный `~/.copilot/mcp-config.json` и замените заглушку токена. Проверьте сервер командой `copilot mcp list`. Copilot CLI также умеет добавлять удалённый сервер через `copilot mcp add --transport http` с параметром `--header`. См. [инструкцию GitHub](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers).
+Добавьте конфиг ниже в личный `~/.copilot/mcp-config.json` и замените заглушку токена. Проверьте сервер командой `copilot mcp list`. Copilot CLI также умеет добавлять удалённый сервер через `copilot mcp add --transport http` с параметром `--header`. См. [инструкцию GitHub](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers).
+
+<details>
+<summary>Показать конфиг (copilot-cli.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "type": "http",
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "your-teletype-public-api-token"
+      },
+      "tools": ["*"]
+    }
+  }
+}
+```
+
+Отдельный файл: [copilot-cli.json](../../examples/clients/copilot-cli.json).
+
+</details>
 
 ## GitHub Copilot в других IDE
 
-Для Copilot в JetBrains IDE, Xcode и Eclipse добавьте [эту запись](../../examples/clients/copilot-other-ides.json) в MCP-конфиг, который открывается из настроек Copilot. Замените заглушку токена в личном конфиге. Здесь используются поля `servers` и `requestInit.headers`, в отличие от примеров для VS Code и Copilot CLI. Visual Studio использует формат `servers` и `inputs` из [примера VS Code](../../examples/clients/vscode.json) в файле `.mcp.json` на уровне решения или пользователя. См. [инструкцию GitHub для других IDE](https://github.com/github/github-mcp-server/blob/main/docs/installation-guides/install-other-copilot-ides.md).
+Для Copilot в JetBrains IDE, Xcode и Eclipse добавьте запись ниже в MCP-конфиг, который открывается из настроек Copilot. Замените заглушку токена в личном конфиге. Здесь используются поля `servers` и `requestInit.headers`, в отличие от примеров для VS Code и Copilot CLI. Visual Studio использует формат `servers` и `inputs` из конфига Visual Studio ниже в файле `.mcp.json` на уровне решения или пользователя. См. [инструкцию GitHub для других IDE](https://github.com/github/github-mcp-server/blob/main/docs/installation-guides/install-other-copilot-ides.md).
+
+<details>
+<summary>Показать конфиг (copilot-other-ides.json)</summary>
+
+```json
+{
+  "servers": {
+    "teletype": {
+      "url": "https://mcp.teletype.app/mcp",
+      "requestInit": {
+        "headers": {
+          "X-Teletype-Api-Token": "your-teletype-public-api-token"
+        }
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [copilot-other-ides.json](../../examples/clients/copilot-other-ides.json).
+
+</details>
+
+<details>
+<summary>Показать конфиг (vscode.json)</summary>
+
+```json
+{
+  "inputs": [
+    {
+      "type": "promptString",
+      "id": "teletype-api-token",
+      "description": "Teletype Public API token",
+      "password": true
+    }
+  ],
+  "servers": {
+    "teletype": {
+      "type": "http",
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "${input:teletype-api-token}"
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [vscode.json](../../examples/clients/vscode.json).
+
+</details>
 
 ## Облачный агент и code review GitHub Copilot
 
-Добавьте [этот конфиг](../../examples/clients/copilot-cloud.json) в **Settings → Copilot → MCP servers** репозитория. Создайте Agents secret с именем `COPILOT_MCP_TELETYPE_API_TOKEN` на уровне репозитория или организации. Пример разрешает только инструменты без записи в Teletype, поскольку облачный агент Copilot вызывает MCP-инструменты без запроса подтверждения. `read_conversation_thread` исключён: этот инструмент может пометить диалог прочитанным. Copilot code review также проверяет аннотацию `readOnlyHint` у каждого инструмента. См. [инструкцию GitHub по MCP в репозитории](https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers).
+Добавьте конфиг ниже в **Settings → Copilot → MCP servers** репозитория. Создайте Agents secret с именем `COPILOT_MCP_TELETYPE_API_TOKEN` на уровне репозитория или организации. Пример разрешает только инструменты без записи в Teletype, поскольку облачный агент Copilot вызывает MCP-инструменты без запроса подтверждения. `read_conversation_thread` исключён: этот инструмент может пометить диалог прочитанным. Copilot code review также проверяет аннотацию `readOnlyHint` у каждого инструмента. См. [инструкцию GitHub по MCP в репозитории](https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers).
+
+<details>
+<summary>Показать конфиг (copilot-cloud.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "type": "http",
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "$COPILOT_MCP_TELETYPE_API_TOKEN"
+      },
+      "tools": [
+        "find_conversations",
+        "lookup_client_profile",
+        "read_client_history",
+        "list_workspace_metadata",
+        "get_project_status",
+        "get_capabilities"
+      ]
+    }
+  }
+}
+```
+
+Отдельный файл: [copilot-cloud.json](../../examples/clients/copilot-cloud.json).
+
+</details>
 
 ## Kiro
 
-Добавьте [этот конфиг](../../examples/clients/kiro.json) в `~/.kiro/settings/mcp.json` или `.kiro/settings/mcp.json` проекта. Передайте `TELETYPE_API_TOKEN` процессу Kiro и подтвердите подстановку переменной по запросу. Один формат работает в Kiro IDE и CLI. Проверьте сервер на вкладке MCP в панели Kiro. См. [инструкцию Kiro по MCP](https://kiro.dev/docs/mcp/configuration/).
+Добавьте конфиг ниже в `~/.kiro/settings/mcp.json` или `.kiro/settings/mcp.json` проекта. Передайте `TELETYPE_API_TOKEN` процессу Kiro и подтвердите подстановку переменной по запросу. Один формат работает в Kiro IDE и CLI. Проверьте сервер на вкладке MCP в панели Kiro. См. [инструкцию Kiro по MCP](https://kiro.dev/docs/mcp/configuration/).
+
+<details>
+<summary>Показать конфиг (kiro.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "${TELETYPE_API_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [kiro.json](../../examples/clients/kiro.json).
+
+</details>
+
+Для Kiro Powers импортируйте каталог `plugin/` как Agent Plugin. Он объединяет локальный stdio-сервер и скилл поддержки. Перед запуском передайте `TELETYPE_API_TOKEN` в окружение процесса Kiro. Нужен Node.js. Подробности в [инструкции Kiro](https://kiro.dev/docs/powers/installation/).
 
 ## Qwen Code
 
-Добавьте [этот конфиг](../../examples/clients/qwen-code.json) в личный `~/.qwen/settings.json` и замените заглушку токена. Поле `httpUrl` выбирает Streamable HTTP. Поле `url` в Qwen Code означает старый SSE, который не используется эндпоинтом Teletype. Проверьте подключение через `/mcp` в Qwen Code. См. [инструкцию Qwen Code по MCP](https://qwenlm.github.io/qwen-code-docs/en/developers/tools/mcp-server/).
+Добавьте конфиг ниже в личный `~/.qwen/settings.json` и замените заглушку токена. Поле `httpUrl` выбирает Streamable HTTP. Поле `url` в Qwen Code означает старый SSE, который не используется эндпоинтом Teletype. Проверьте подключение через `/mcp` в Qwen Code. См. [инструкцию Qwen Code по MCP](https://qwenlm.github.io/qwen-code-docs/en/developers/tools/mcp-server/).
+
+<details>
+<summary>Показать конфиг (qwen-code.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "httpUrl": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "your-teletype-public-api-token"
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [qwen-code.json](../../examples/clients/qwen-code.json).
+
+</details>
 
 ## Rovo Dev CLI
 
-Добавьте [этот конфиг](../../examples/clients/rovo-dev.json) в личный `~/.rovodev/mcp.json` и замените заглушку токена. Команда `acli rovodev mcp` откроет файл настроек, а `/mcp` в интерактивной сессии покажет состояние подключения. См. [инструкцию Rovo Dev по MCP](https://support.atlassian.com/rovo/docs/connect-to-an-mcp-server-in-rovo-dev-cli/).
+Добавьте конфиг ниже в личный `~/.rovodev/mcp.json` и замените заглушку токена. Команда `acli rovodev mcp` откроет файл настроек, а `/mcp` в интерактивной сессии покажет состояние подключения. См. [инструкцию Rovo Dev по MCP](https://support.atlassian.com/rovo/docs/connect-to-an-mcp-server-in-rovo-dev-cli/).
+
+<details>
+<summary>Показать конфиг (rovo-dev.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "transport": "http",
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "your-teletype-public-api-token"
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [rovo-dev.json](../../examples/clients/rovo-dev.json).
+
+</details>
+
+## Расширение Gemini CLI
+
+Для Gemini CLI установите расширение командой `gemini extensions install https://github.com/Teletype-App/teletype-mcp-server`. При запросе задайте **Teletype Public API token**. Настройка объявлена секретной и передаёт токен в заголовок хостед-сервера. Для изменения выполните `gemini extensions config teletype`, для проверки инструментов откройте `/mcp` внутри Gemini CLI. Расширение также загружает общий регламент поддержки в контекст. Подробности в [документации Gemini](https://geminicli.com/docs/extensions/).
+
+## OpenClaw
+
+Добавьте конфиг ниже в приватный `~/.openclaw/openclaw.json`, сохранив существующие записи. OpenClaw использует `mcp.servers`. Задайте `TELETYPE_API_TOKEN` в окружении процесса Gateway. Проверьте подключение командой `openclaw mcp doctor teletype --probe`. Отдельная установка скилла поддержки не добавляет MCP-подключение. Подробности в [документации OpenClaw](https://docs.openclaw.ai/tools/mcp).
+
+<details>
+<summary>Показать конфиг (openclaw.json)</summary>
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "teletype": {
+        "url": "https://mcp.teletype.app/mcp",
+        "transport": "streamable-http",
+        "headers": {
+          "X-Teletype-Api-Token": "${TELETYPE_API_TOKEN}"
+        }
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [openclaw.json](../../examples/clients/openclaw.json).
+
+</details>
 
 ## Antigravity CLI
 
-Добавьте запись сервера из [этого конфига](../../examples/clients/antigravity.json) в `~/.gemini/config/mcp_config.json` или в `.agents/mcp_config.json` своего проекта. Остальные MCP-серверы сохраните. Проверьте подключение командой `agy mcp list`. Сервер получает `TELETYPE_API_TOKEN` из окружения клиента. Для русских описаний и ответов добавьте в запись сервера `"env": { "TELETYPE_MCP_LOCALE": "ru" }`.
+Добавьте запись сервера из конфига ниже в `~/.gemini/config/mcp_config.json` или в `.agents/mcp_config.json` своего проекта. Остальные MCP-серверы сохраните. Проверьте подключение командой `agy mcp list`. Сервер получает `TELETYPE_API_TOKEN` из окружения клиента. Для русских описаний и ответов добавьте в запись сервера `"env": { "TELETYPE_MCP_LOCALE": "ru" }`.
+
+<details>
+<summary>Показать конфиг (antigravity.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "command": "npx",
+      "args": ["-y", "teletype-mcp-server", "--stdio"],
+      "tools": {
+        "find_conversations": { "eager": true },
+        "find_messages": { "eager": true },
+        "lookup_client_profile": { "eager": true },
+        "list_clients": { "eager": true },
+        "read_conversation_thread": { "eager": true },
+        "read_client_history": { "eager": true },
+        "send_reply_to_client": { "eager": true },
+        "create_dialog_by_phone": { "eager": true },
+        "annotate_client_record": { "eager": true },
+        "resolve_conversation": { "eager": true },
+        "list_workspace_metadata": { "eager": true },
+        "get_project_status": { "eager": true },
+        "manage_sent_message": { "eager": true },
+        "send_whatsapp_template": { "eager": true },
+        "manage_operator_group": { "eager": true },
+        "configure_project_webhook": { "eager": true },
+        "get_capabilities": { "eager": true }
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [antigravity.json](../../examples/clients/antigravity.json).
+
+</details>
 
 В июне 2026 года Google перевела индивидуальные аккаунты с Gemini CLI на Antigravity CLI. Для корпоративных пользователей и авторизации по API-ключу Gemini CLI продолжает работать, но эта инструкция рассчитана на Antigravity CLI. См. [объявление Google](https://github.com/google-gemini/gemini-cli/discussions/28017).
 
@@ -85,39 +470,242 @@ cp -r node_modules/teletype-mcp-server/plugin/skills/teletype-support ~/.agents/
 
 ## Devin
 
-Администратор организации добавляет сервер один раз: вкладка **Customize → MCPs**, **Add MCP → Add custom MCP**, транспорт `STDIO`, затем поля из [этого образца](../../examples/clients/devin.json): `command: npx`, `args: ["-y", "teletype-mcp-server", "--stdio"]` и переменная окружения `TELETYPE_API_TOKEN`. После этого участники включают сервер на той же вкладке в своих сессиях. Devin запускает stdio-серверы в своём окружении, поэтому проверяйте запуском сессии с вопросом про инструменты Teletype. Кнопка «Test tools» работает только для удалённых серверов. Подробности в [документации Devin MCP](https://docs.devin.ai/work-with-devin/mcp).
+Администратор организации добавляет сервер один раз: вкладка **Customize → MCPs**, **Add MCP → Add custom MCP**, транспорт `STDIO`, затем поля из образца ниже: `command: npx`, `args: ["-y", "teletype-mcp-server", "--stdio"]` и переменная окружения `TELETYPE_API_TOKEN`. После этого участники включают сервер на той же вкладке в своих сессиях. Devin запускает stdio-серверы в своём окружении, поэтому проверяйте запуском сессии с вопросом про инструменты Teletype. Кнопка «Test tools» работает только для удалённых серверов. Подробности в [документации Devin MCP](https://docs.devin.ai/work-with-devin/mcp).
+
+<details>
+<summary>Показать конфиг (devin.json)</summary>
+
+```json
+{
+  "transport": "STDIO",
+  "command": "npx",
+  "args": ["-y", "teletype-mcp-server", "--stdio"],
+  "env_variables": {
+    "TELETYPE_API_TOKEN": "your-teletype-public-api-token"
+  }
+}
+```
+
+Отдельный файл: [devin.json](../../examples/clients/devin.json).
+
+</details>
 
 ## Windsurf Cascade
 
-Откройте **Open MCP config file** через меню **Actions → MCPs** на панели Cascade и добавьте запись из [этого конфига](../../examples/clients/windsurf.json) в объект `mcpServers`. В актуальном конфиге Cascade запись `${env:TELETYPE_API_TOKEN}` подставляется в HTTP-заголовок. Сделайте токен доступным процессу приложения и проверьте сервер на панели MCP. Это настройка прежнего агента Cascade в Devin Desktop. Новый Devin Local использует свои MCP-настройки. См. [инструкцию Cascade MCP](https://docs.devin.ai/desktop/cascade/mcp).
+Откройте **Open MCP config file** через меню **Actions → MCPs** на панели Cascade и добавьте запись из конфига ниже в объект `mcpServers`. В актуальном конфиге Cascade запись `${env:TELETYPE_API_TOKEN}` подставляется в HTTP-заголовок. Сделайте токен доступным процессу приложения и проверьте сервер на панели MCP. Это настройка прежнего агента Cascade в Devin Desktop. Новый Devin Local использует свои MCP-настройки. См. [инструкцию Cascade MCP](https://docs.devin.ai/desktop/cascade/mcp).
+
+<details>
+<summary>Показать конфиг (windsurf.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "serverUrl": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "${env:TELETYPE_API_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [windsurf.json](../../examples/clients/windsurf.json).
+
+</details>
 
 ## Zed
 
-Добавьте запись из [этого конфига](../../examples/clients/zed.json) в блок `context_servers` файла настроек Zed или через **Settings → AI → MCP Servers → Add Server → Add Local Server** с теми же командой, аргументами и переменной `TELETYPE_API_TOKEN`. Для хостед-эндпоинта используйте удалённую запись: `"url": "https://mcp.teletype.app/mcp"` с `"headers": { "X-Teletype-Api-Token": "ваш-токен-teletype-public-api" }`. Зелёный индикатор с подсказкой «Server is active» на странице настроек MCP Servers подтверждает подключение. Подробности в [документации Zed MCP](https://zed.dev/docs/ai/mcp).
+Добавьте запись из конфига ниже в блок `context_servers` файла настроек Zed или через **Settings → AI → MCP Servers → Add Server → Add Local Server** с теми же командой, аргументами и переменной `TELETYPE_API_TOKEN`. Для хостед-эндпоинта используйте удалённую запись: `"url": "https://mcp.teletype.app/mcp"` с `"headers": { "X-Teletype-Api-Token": "ваш-токен-teletype-public-api" }`. Зелёный индикатор с подсказкой «Server is active» на странице настроек MCP Servers подтверждает подключение. Подробности в [документации Zed MCP](https://zed.dev/docs/ai/mcp).
+
+<details>
+<summary>Показать конфиг (zed.json)</summary>
+
+```json
+{
+  "context_servers": {
+    "teletype": {
+      "command": "npx",
+      "args": ["-y", "teletype-mcp-server", "--stdio"],
+      "env": { "TELETYPE_API_TOKEN": "your-teletype-public-api-token" }
+    }
+  }
+}
+```
+
+Отдельный файл: [zed.json](../../examples/clients/zed.json).
+
+</details>
 
 ## ZCode
 
-Используйте **Settings → MCP Servers → New MCP Server** с типом `stdio` или вставьте JSON из [этого файла](../../examples/clients/zcode.json). При ручном редактировании ZCode читает `mcp.servers` из `~/.zcode/cli/config.json` (пользовательский уровень) или `.zcode/config.json` в корне проекта (уровень проекта). Также принимается стандартный блок `mcpServers` в `~/.agents/mcp.json` или `.agents/mcp.json` проекта. В любом случае задайте `TELETYPE_API_TOKEN` в переменных окружения сервера. Подробности в [документации ZCode MCP](https://zcode.z.ai/en/docs/mcp-services).
+Используйте **Settings → MCP Servers → New MCP Server** с типом `stdio` или вставьте JSON из конфига ниже. При ручном редактировании ZCode читает `mcp.servers` из `~/.zcode/cli/config.json` (пользовательский уровень) или `.zcode/config.json` в корне проекта (уровень проекта). Также принимается стандартный блок `mcpServers` в `~/.agents/mcp.json` или `.agents/mcp.json` проекта. В любом случае задайте `TELETYPE_API_TOKEN` в переменных окружения сервера. Подробности в [документации ZCode MCP](https://zcode.z.ai/en/docs/mcp-services).
+
+<details>
+<summary>Показать конфиг (zcode.json)</summary>
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "teletype": {
+        "command": "npx",
+        "args": ["-y", "teletype-mcp-server", "--stdio"],
+        "env": { "TELETYPE_API_TOKEN": "your-teletype-public-api-token" }
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [zcode.json](../../examples/clients/zcode.json).
+
+</details>
 
 ## Cline
 
-В Cline откройте **MCP Servers**, выберите **Configure** и добавьте [этот конфиг](../../examples/clients/cline.json) в личные настройки MCP. Замените заглушку токена. Тип `streamableHttp` нужен для хостед-эндпоинта: без поля `type` Cline использует старый SSE. В Cline CLI также есть мастер настройки `cline mcp`. См. [инструкцию Cline MCP](https://github.com/cline/cline/blob/main/docs/mcp/mcp-overview.mdx).
+В Cline откройте **MCP Servers**, выберите **Configure** и добавьте конфиг ниже в личные настройки MCP. Замените заглушку токена. Тип `streamableHttp` нужен для хостед-эндпоинта: без поля `type` Cline использует старый SSE. В Cline CLI также есть мастер настройки `cline mcp`. См. [инструкцию Cline MCP](https://github.com/cline/cline/blob/main/docs/mcp/mcp-overview.mdx).
+
+<details>
+<summary>Показать конфиг (cline.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "type": "streamableHttp",
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "your-teletype-public-api-token"
+      },
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+Отдельный файл: [cline.json](../../examples/clients/cline.json).
+
+</details>
 
 ## Roo Code
 
-Если вы уже используете Roo Code, добавьте [этот конфиг](../../examples/clients/roo-code.json) в личные настройки MCP и замените заглушку токена. Для хостед-эндпоинта Roo Code использует тип `streamable-http` с дефисом. [Репозиторий Roo Code архивирован](https://github.com/RooCodeInc/Roo-Code), поэтому пример оставлен для действующих установок. См. [инструкцию GitHub MCP для Roo Code](https://github.com/github/github-mcp-server/blob/main/docs/installation-guides/install-roo-code.md).
+Если вы уже используете Roo Code, добавьте конфиг ниже в личные настройки MCP и замените заглушку токена. Для хостед-эндпоинта Roo Code использует тип `streamable-http` с дефисом. [Репозиторий Roo Code архивирован](https://github.com/RooCodeInc/Roo-Code), поэтому пример оставлен для действующих установок. См. [инструкцию GitHub MCP для Roo Code](https://github.com/github/github-mcp-server/blob/main/docs/installation-guides/install-roo-code.md).
+
+<details>
+<summary>Показать конфиг (roo-code.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "type": "streamable-http",
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "your-teletype-public-api-token"
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [roo-code.json](../../examples/clients/roo-code.json).
+
+</details>
 
 ## Junie
 
-Добавьте [этот конфиг](../../examples/clients/junie.json) в личный `~/.junie/mcp/mcp.json` и замените заглушку токена. Junie в JetBrains IDE и Junie CLI используют один формат MCP. Проверьте статус сервера через `/mcp` в Junie CLI или **Tools → Junie → MCP Settings** в IDE. См. [инструкцию Junie MCP](https://junie.jetbrains.com/docs/junie-cli-mcp-configuration.html).
+Добавьте конфиг ниже в личный `~/.junie/mcp/mcp.json` и замените заглушку токена. Junie в JetBrains IDE и Junie CLI используют один формат MCP. Проверьте статус сервера через `/mcp` в Junie CLI или **Tools → Junie → MCP Settings** в IDE. См. [инструкцию Junie MCP](https://junie.jetbrains.com/docs/junie-cli-mcp-configuration.html).
+
+<details>
+<summary>Показать конфиг (junie.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "teletype": {
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "your-teletype-public-api-token"
+      }
+    }
+  }
+}
+```
+
+Отдельный файл: [junie.json](../../examples/clients/junie.json).
+
+</details>
 
 ## Continue
 
-Добавьте запись `mcpServers` из [этого YAML-фрагмента](../../examples/clients/continue.yaml) в свой `config.yaml` для Continue. Сохраните `TELETYPE_API_TOKEN=...` в личном `~/.continue/.env`. Для Continue CLI можно также экспортировать переменную перед запуском `cn`. MCP-инструменты доступны в режиме Agent. См. [инструкцию Continue по MCP](https://docs.continue.dev/customize/deep-dives/mcp) и [инструкцию по локальным секретам](https://docs.continue.dev/faqs#managing-local-secrets-and-environment-variables).
+Добавьте запись `mcpServers` из YAML-фрагмента ниже в свой `config.yaml` для Continue. Сохраните `TELETYPE_API_TOKEN=...` в личном `~/.continue/.env`. Для Continue CLI можно также экспортировать переменную перед запуском `cn`. MCP-инструменты доступны в режиме Agent. См. [инструкцию Continue по MCP](https://docs.continue.dev/customize/deep-dives/mcp) и [инструкцию по локальным секретам](https://docs.continue.dev/faqs#managing-local-secrets-and-environment-variables).
+
+<details>
+<summary>Показать конфиг (continue.yaml)</summary>
+
+```yaml
+mcpServers:
+  - name: Teletype
+    type: streamable-http
+    url: https://mcp.teletype.app/mcp
+    requestOptions:
+      headers:
+        X-Teletype-Api-Token: "${{ secrets.TELETYPE_API_TOKEN }}"
+```
+
+Отдельный файл: [continue.yaml](../../examples/clients/continue.yaml).
+
+</details>
 
 ## Goose
 
-Добавьте [этот YAML-фрагмент](../../examples/clients/goose.yaml) в личный `~/.config/goose/config.yaml` и замените заглушку токена. Goose подключает MCP-серверы как расширения и использует тип `streamable_http` для хостед-эндпоинта. Удалённое расширение Streamable HTTP можно также добавить через `goose configure`. См. [инструкцию Goose по расширениям](https://github.com/aaif-goose/goose/blob/main/documentation/docs/getting-started/using-extensions.md) и [формат конфига](https://github.com/aaif-goose/goose/blob/main/documentation/docs/guides/config-files.md).
+Для локального подключения добавьте stdio-конфиг ниже в личный `~/.config/goose/config.yaml` и замените заглушку токена. Нужен Node.js 20.19+, 22.13+ или 24.x. Сохраните настройки других расширений.
+
+<details>
+<summary>Показать конфиг (goose-stdio.yaml)</summary>
+
+```yaml
+extensions:
+  teletype:
+    name: teletype
+    type: stdio
+    enabled: true
+    cmd: npx
+    args:
+      - -y
+      - teletype-mcp-server
+      - --stdio
+    envs:
+      TELETYPE_API_TOKEN: your-teletype-public-api-token
+    timeout: 300
+```
+
+Отдельный файл: [goose-stdio.yaml](../../examples/clients/goose-stdio.yaml).
+
+</details>
+
+Добавьте YAML-фрагмент ниже в личный `~/.config/goose/config.yaml` и замените заглушку токена. Goose подключает MCP-серверы как расширения и использует тип `streamable_http` для хостед-эндпоинта. Удалённое расширение Streamable HTTP можно также добавить через `goose configure`. См. [инструкцию Goose по расширениям](https://github.com/aaif-goose/goose/blob/main/documentation/docs/getting-started/using-extensions.md) и [формат конфига](https://github.com/aaif-goose/goose/blob/main/documentation/docs/guides/config-files.md).
+
+<details>
+<summary>Показать конфиг (goose.yaml)</summary>
+
+```yaml
+extensions:
+  teletype:
+    name: teletype
+    type: streamable_http
+    enabled: true
+    uri: https://mcp.teletype.app/mcp
+    headers:
+      X-Teletype-Api-Token: your-teletype-public-api-token
+    timeout: 300
+```
+
+Отдельный файл: [goose.yaml](../../examples/clients/goose.yaml).
+
+</details>
 
 ## n8n
 
@@ -125,11 +713,47 @@ cp -r node_modules/teletype-mcp-server/plugin/skills/teletype-support ~/.agents/
 
 ## Flowise
 
-Создайте в Flowise переменную `teletypeApiToken` со значением Public API токена. Добавьте **Custom MCP** к узлу Agent и вставьте [этот конфиг](../../examples/clients/flowise.json) в поле **MCP Server Config**. Обновите **Available Actions**, чтобы загрузить инструменты Teletype. См. [инструкцию Flowise для Custom MCP](https://docs.flowiseai.com/tutorials/tools-and-mcp).
+Создайте в Flowise переменную `teletypeApiToken` со значением Public API токена. Добавьте **Custom MCP** к узлу Agent и вставьте конфиг ниже в поле **MCP Server Config**. Обновите **Available Actions**, чтобы загрузить инструменты Teletype. См. [инструкцию Flowise для Custom MCP](https://docs.flowiseai.com/tutorials/tools-and-mcp).
+
+<details>
+<summary>Показать конфиг (flowise.json)</summary>
+
+```json
+{
+  "url": "https://mcp.teletype.app/mcp",
+  "headers": {
+    "X-Teletype-Api-Token": "{{$vars.teletypeApiToken}}"
+  }
+}
+```
+
+Отдельный файл: [flowise.json](../../examples/clients/flowise.json).
+
+</details>
 
 ## LibreChat
 
-Добавьте [этот YAML-фрагмент](../../examples/clients/librechat.yaml) в `librechat.yaml`. Каждый пользователь вводит свой Public API токен в настройках MCP, а `customUserVars` позволяет не хранить его в общем конфиге. Выберите сервер Teletype в меню инструментов чата или Agent Builder. Сервер также можно добавить через интерфейс LibreChat: выберите Streamable HTTP, хостед-адрес и авторизацию API Key с пользовательским заголовком `X-Teletype-Api-Token`. См. [инструкцию LibreChat по MCP](https://www.librechat.ai/docs/features/mcp).
+Добавьте YAML-фрагмент ниже в `librechat.yaml`. Каждый пользователь вводит свой Public API токен в настройках MCP, а `customUserVars` позволяет не хранить его в общем конфиге. Выберите сервер Teletype в меню инструментов чата или Agent Builder. Сервер также можно добавить через интерфейс LibreChat: выберите Streamable HTTP, хостед-адрес и авторизацию API Key с пользовательским заголовком `X-Teletype-Api-Token`. См. [инструкцию LibreChat по MCP](https://www.librechat.ai/docs/features/mcp).
+
+<details>
+<summary>Показать конфиг (librechat.yaml)</summary>
+
+```yaml
+mcpServers:
+  teletype:
+    type: streamable-http
+    url: https://mcp.teletype.app/mcp
+    headers:
+      X-Teletype-Api-Token: "{{TELETYPE_API_TOKEN}}"
+    customUserVars:
+      TELETYPE_API_TOKEN:
+        title: Teletype Public API token
+        description: Enter your Teletype Public API token
+```
+
+Отдельный файл: [librechat.yaml](../../examples/clients/librechat.yaml).
+
+</details>
 
 ## Open WebUI