Tailscale MCP Server — MCP-сервер для Claude Code: управление tailnet
MCP-сервер, который даёт агенту доступ к admin API Tailscale: устройства, ACL, DNS, ключи, пользователи. Пригодится, когда нужно спросить про tailnet и сразу что-то поменять.
claude mcp add tailscale-mcp -- npx -y @yawlabs/tailscale-mcpЧто делает Tailscale MCP Server
Сервер оборачивает Tailscale v2 API в типизированные инструменты: 97 инструментов для admin API, 6 необязательных диагностических через локальный CLI, один инструмент-каталог и 4 ресурса. Охвачены устройства, ACL, DNS, ключи и trust credentials, пользователи, приглашения, вебхуки, log streaming, posture, services и organization tailnets. У каждого инструмента схема входа на Zod и структурированный ответ, поэтому разбирать вывод tailscale status --json | jq не придётся.
Смысл не в замене curl. Агент собирает цепочку из нескольких эндпоинтов за один ход: находит устройства без подключения и с отключённым сроком ключа, поднимает audit log и объясняет, кто менял DNS ночью, готовит минимальный diff для ACL с сохранением комментариев. Записи помечены destructiveHint или idempotentHint, так что клиент может требовать подтверждения на изменения и пропускать его на чтение.
Для работы нужен ключ API tailnet. Часть инструментов диагностики опирается на локальный CLI, а интеграционный набор включается переменной RUN_INTEGRATION_TESTS=1 вместе с ключом. Сервер общается по stdio — если ваш клиент умеет только URL-адресуемые Streamable-HTTP или SSE, подключить его так не выйдет. Если задача — один эндпоинт в CI, проще взять curl: интерактивная работа с неясной ещё целью — вот где этот сервер себя оправдывает.
Какие задачи решает
- найти устройства, которые давно не выходили на связь и с отключённым сроком ключа
- разобрать audit log и понять, кто менял DNS ночью
- подготовить diff для ACL с сохранением комментариев в HuJSON
- выпустить OAuth-клиент для CI с ограниченными правами
- отозвать старые auth-ключи и напечатать новые
Примеры запросов агенту
- Покажи устройства, которые не выходили на связь 30 дней и у которых отключён срок действия ключа
- Кто менял DNS за последние 24 часа? Собери изменения из audit log и объясни
- Предложи изменение ACL:
tag:mobileвидитtag:dashboard, но неtag:db, комментарии сохрани
Как установить Tailscale MCP Server
Командой платформы
claude mcp add tailscale-mcp -- npx -y @yawlabs/tailscale-mcpКомандой платформы
codex mcp add tailscale-mcp-server -- npx -y @yawlabs/tailscale-mcpФайл настроек
{
"mcpServers": {
"tailscale-mcp-server": {
"command": "npx",
"args": [
"-y",
"@yawlabs/tailscale-mcp"
]
}
}
}Файл настроек
{
"servers": {
"tailscale-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@yawlabs/tailscale-mcp"
]
}
}
}Командой платформы
gemini mcp add tailscale-mcp-server npx -y @yawlabs/tailscale-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Tailscale MCP Server
Как установить Tailscale MCP Server в Claude Code?
Выполните claude mcp add tailscale-mcp -- npx -y @yawlabs/tailscale-mcp. Сервер запустится через npx, отдельная установка не нужна.
Что делает Tailscale MCP Server?
Даёт агенту типизированный доступ к admin API Tailscale: устройства, ACL, DNS, ключи, пользователи, вебхуки, log streaming и posture. Агент может собрать ответ из нескольких эндпоинтов за один ход и предложить изменения.
Чем это отличается от официальных MCP-инструментов Tailscale?
Официальные коннекторы в Aperture дают присоединить одну ноду или выполнить одну команду по SSH, а tailscale/tailscale-skill — только справочный материал без своего сервера. Здесь admin API выставлен как типизированные инструменты.
