# mcp-oauth

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 21 установка · ★ 1 у репозитория
- Автор: clavia-labs
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/clavia-labs/skills/tree/HEAD/mcp-oauth/SKILL.md
- Обновлён: 2026-02-14
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add clavia-labs/skills --skill mcp-oauth -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/mcp-oauth/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/mcp-oauth/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add clavia-labs/skills --skill mcp-oauth -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/mcp-oauth/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add clavia-labs/skills --skill mcp-oauth -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/mcp-oauth/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install clavia-labs/skills mcp-oauth
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/mcp-oauth/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add clavia-labs/skills --skill mcp-oauth -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/clavia-labs/skills --path mcp-oauth
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/mcp-oauth/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add clavia-labs/skills --skill mcp-oauth -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/clavia-labs/skills/tree/HEAD/mcp-oauth/SKILL.md

## Когда брать
- подключиться к MCP-серверу за OAuth и получить рабочий токен
- разобрать, почему сервер отвечает `invalid_token`
- поймать код авторизации на localhost без ручного копирования
- посмотреть, какие инструменты отдаёт чужой MCP-сервер
- обновить истёкший токен и повторить вызов

## Примеры запросов агенту
- Авторизуйся на MCP-сервере `MCP_SERVER_URL` и покажи, какие у него есть инструменты.
- Сервер вернул 401 — обнови токен и повтори запрос.
- Вызови инструмент `<tool_name>` с пустыми аргументами.

## Похожие
- [oauth-oidc-misconfiguration](https://affpapa.org/nevibecode/skills/oauth-oidc-misconfiguration.md) — скилл · 4100 установок
- [oauth-implementation](https://affpapa.org/nevibecode/skills/oauth-implementation.md) — скилл · 768 установок
- [oauth-oidc-expert](https://affpapa.org/nevibecode/agents/oauth-oidc-expert.md) — субагент · ★ 1029 у репозитория
- [oauth](https://affpapa.org/nevibecode/skills/mcollina-oauth.md) — скилл · 1400 установок
- [openrouter-oauth](https://affpapa.org/nevibecode/skills/openrouter-oauth.md) — скилл · 362 установки
- [oauth-oidc-implementer](https://affpapa.org/nevibecode/skills/oauth-oidc-implementer.md) — скилл · 183 установки

Из того же набора: [clavia-labs/skills](https://affpapa.org/nevibecode/by/clavia-labs/skills.md) — 2 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
