mcp-oauth — скилл для Claude Code: вход на MCP-сервер по OAuth
Скилл ведёт агента через OAuth 2.1 к MCP-серверу: метаданные, PKCE, локальный колбэк на порту 9999, обмен кода на токен и первый запрос к инструментам.
лицензия не указана 21 установок ★ 1 обновлён 2026-02-14
npx skills add clavia-labs/skills --skill mcp-oauth -a claude-codeЧто делает mcp-oauth
Скилл проводит агента через полный вход на MCP-сервер, закрытый OAuth 2.1. Сначала он забирает метаданные защищённого ресурса и сервера авторизации, потом регистрирует клиента и собирает ссылку с PKCE-челленджем. Браузер открывается сам, локальный сервер на порту 9999 ловит код и складывает его в /tmp/mcp_oauth_code.txt.
Дальше обмен кода на токен и инициализация MCP-сессии с заголовком Accept: application/json, text/event-stream. Потом tools/list и вызов инструментов. При 401 с refresh-токеном скилл обновляет токен и повторяет запрос. Всё идёт через curl и два вложенных Node.js-скрипта: scripts/pkce.js и scripts/callback_server.js.
Порт 9999 должен быть свободен, иначе сервер обратного вызова не поднимется — в инструкции на этот случай есть lsof -ti:9999 | xargs kill -9. Если сервер не поддерживает динамическую регистрацию, скилл попросит у вас client_id.
Какие задачи решает
- подключиться к MCP-серверу за OAuth и получить рабочий токен
- разобрать, почему сервер отвечает
invalid_token - поймать код авторизации на localhost без ручного копирования
- посмотреть, какие инструменты отдаёт чужой MCP-сервер
- обновить истёкший токен и повторить вызов
Примеры запросов агенту
- Авторизуйся на MCP-сервере
MCP_SERVER_URLи покажи, какие у него есть инструменты. - Сервер вернул 401 — обнови токен и повтори запрос.
- Вызови инструмент
<tool_name>с пустыми аргументами.
Как установить mcp-oauth
1Через Skills CLI (Vercel)
npx skills add clavia-labs/skills --skill mcp-oauth -a claude-code2Вручную: положить файлы
~/.claude/skills/mcp-oauth/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mcp-oauth/
1Через Skills CLI (Vercel)
npx skills add clavia-labs/skills --skill mcp-oauth -a codex2Вручную: положить файлы
.agents/skills/mcp-oauth/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add clavia-labs/skills --skill mcp-oauth -a cursor2Вручную: положить файлы
.cursor/skills/mcp-oauth/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install clavia-labs/skills mcp-oauth2Вручную: положить файлы
.github/skills/mcp-oauth/SKILL.md1Через Skills CLI (Vercel)
npx skills add clavia-labs/skills --skill mcp-oauth -a gemini-cli2Командой платформы
gemini skills install https://github.com/clavia-labs/skills --path mcp-oauthВручную: положить файлы
.devin/skills/mcp-oauth/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add clavia-labs/skills --skill mcp-oauth -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mcp-oauth
Как установить mcp-oauth в Claude Code?
Выполните npx skills add clavia-labs/skills --skill mcp-oauth -a claude-code. Скилл появится в ~/.claude/skills/mcp-oauth/SKILL.md.
Что делает mcp-oauth?
Проводит агента по цепочке OAuth 2.1 до рабочей MCP-сессии: находит эндпоинты, регистрирует клиента, ловит код на localhost, меняет его на токен и вызывает инструменты сервера.
Что нужно, чтобы скилл заработал?
curl и Node.js для вложенных скриптов, плюс свободный порт 9999. Если сервер не умеет динамическую регистрацию клиентов, client_id придётся вписать самому.