К основному содержанию
скилл CX Codex

mcp-oauth — скилл для Claude Code: вход на MCP-сервер по OAuth

Скилл ведёт агента через OAuth 2.1 к MCP-серверу: метаданные, PKCE, локальный колбэк на порту 9999, обмен кода на токен и первый запрос к инструментам.

лицензия не указана 21 установок ★ 1 обновлён 2026-02-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add clavia-labs/skills --skill mcp-oauth -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/mcp-oauth/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/mcp-oauth/

По шагам, с командами для каждой платформы: Как установить скилл в 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 придётся вписать самому.

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
oauth-oidc-misconfiguration yaklang Скилл oauth-oidc-misconfiguration для Claude Code проверяет настройки OAuth 2.0 и OpenID Connect и выявляет уязвимости в redirect_uri, state, PKCE и привязке аккаунтов. CX Codex +1 4 100установок oauth-implementation Mindrally Скилл oauth-implementation для Claude Code задаёт правила настройки OAuth 2.0 и 2.1 с PKCE, ротацией токенов и проверкой redirect URI. CX Codex +1 768установок oauth-oidc-expert 0xfurai oauth-oidc-expert — субагент для Claude Code по OAuth 2.0 и OpenID Connect. Он помогает разбирать потоки входа, токены и защиту API. CX Codex ★ 1 029звёзд репо oauth mcollina Настраивает OAuth 2.0 и 2.1 в приложениях Fastify с PKCE и ротацией токенов. Проверяет JWT, настраивает сессии и устраняет ошибки redirect URI. CX Codex +1 1 400установок openrouter-oauth OpenRouterTeam Скилл openrouter-oauth помогает встроить вход через OpenRouter в веб-приложение по протоколу OAuth PKCE без бэкенда и регистрации клиента. CX Codex +1 362установок oauth-oidc-implementer curiositech Скилл oauth-oidc-implementer помогает настроить авторизацию по протоколам OAuth 2.0 и OIDC, вход через соцсети и безопасную работу с JWT в серверных или клиентских приложениях. CX Codex +1 183установок

Из того же набора2

Спонсоры проекта

Компании, которые помогают держать аналитику открытой