claude-code-tutor 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +315 -0
- package/dist/chunk-A6ZZXTHB.js +65 -0
- package/dist/chunk-OYDUGORC.js +75 -0
- package/dist/cli.js +1362 -0
- package/dist/meta-TZOSLFST.js +13 -0
- package/dist/tutor-memory-M6GNB3LQ.js +19 -0
- package/package.json +61 -0
- package/skills-fallback/cc-agent-teams/SKILL.md +38 -0
- package/skills-fallback/cc-best-practices/SKILL.md +34 -0
- package/skills-fallback/cc-changelog/SKILL.md +20 -0
- package/skills-fallback/cc-channels/SKILL.md +34 -0
- package/skills-fallback/cc-cli-reference/SKILL.md +16 -0
- package/skills-fallback/cc-commands/SKILL.md +12 -0
- package/skills-fallback/cc-common-workflows-ask-claude-about-its-capabilities/SKILL.md +43 -0
- package/skills-fallback/cc-common-workflows-create-pull-requests/SKILL.md +26 -0
- package/skills-fallback/cc-common-workflows-fix-bugs-efficiently/SKILL.md +30 -0
- package/skills-fallback/cc-common-workflows-get-notified-when-claude-needs-your-attention/SKILL.md +95 -0
- package/skills-fallback/cc-common-workflows-handle-documentation/SKILL.md +36 -0
- package/skills-fallback/cc-common-workflows-next-steps/SKILL.md +22 -0
- package/skills-fallback/cc-common-workflows-refactor-code/SKILL.md +36 -0
- package/skills-fallback/cc-common-workflows-reference-files-and-directories/SKILL.md +47 -0
- package/skills-fallback/cc-common-workflows-resume-previous-conversations/SKILL.md +57 -0
- package/skills-fallback/cc-common-workflows-run-claude-on-a-schedule/SKILL.md +22 -0
- package/skills-fallback/cc-common-workflows-run-parallel-claude-code-sessions-with-git-worktrees/SKILL.md +43 -0
- package/skills-fallback/cc-common-workflows-understand-new-codebases/SKILL.md +81 -0
- package/skills-fallback/cc-common-workflows-use-claude-as-a-unix-style-utility/SKILL.md +83 -0
- package/skills-fallback/cc-common-workflows-use-extended-thinking-thinking-mode/SKILL.md +15 -0
- package/skills-fallback/cc-common-workflows-use-plan-mode-for-safe-code-analysis/SKILL.md +80 -0
- package/skills-fallback/cc-common-workflows-use-specialized-subagents/SKILL.md +69 -0
- package/skills-fallback/cc-common-workflows-work-with-images/SKILL.md +71 -0
- package/skills-fallback/cc-common-workflows-work-with-tests/SKILL.md +36 -0
- package/skills-fallback/cc-github-actions/SKILL.md +44 -0
- package/skills-fallback/cc-headless/SKILL.md +40 -0
- package/skills-fallback/cc-hooks-config/SKILL.md +32 -0
- package/skills-fallback/cc-hooks-events/SKILL.md +24 -0
- package/skills-fallback/cc-hooks-guide/SKILL.md +59 -0
- package/skills-fallback/cc-hooks-io/SKILL.md +11 -0
- package/skills-fallback/cc-learning-path/SKILL.md +77 -0
- package/skills-fallback/cc-mcp-add-mcp-servers-from-json-configuration/SKILL.md +36 -0
- package/skills-fallback/cc-mcp-authenticate-with-remote-mcp-servers/SKILL.md +52 -0
- package/skills-fallback/cc-mcp-import-mcp-servers-from-claude-desktop/SKILL.md +28 -0
- package/skills-fallback/cc-mcp-installing-mcp-servers/SKILL.md +86 -0
- package/skills-fallback/cc-mcp-managed-mcp-configuration/SKILL.md +55 -0
- package/skills-fallback/cc-mcp-mcp-installation-scopes/SKILL.md +57 -0
- package/skills-fallback/cc-mcp-mcp-output-limits-and-warnings/SKILL.md +46 -0
- package/skills-fallback/cc-mcp-popular-mcp-servers/SKILL.md +11 -0
- package/skills-fallback/cc-mcp-practical-examples/SKILL.md +102 -0
- package/skills-fallback/cc-mcp-respond-to-mcp-elicitation-requests/SKILL.md +20 -0
- package/skills-fallback/cc-mcp-scale-with-mcp-tool-search/SKILL.md +29 -0
- package/skills-fallback/cc-mcp-use-claude-code-as-an-mcp-server/SKILL.md +59 -0
- package/skills-fallback/cc-mcp-use-mcp-prompts-as-commands/SKILL.md +40 -0
- package/skills-fallback/cc-mcp-use-mcp-resources/SKILL.md +45 -0
- package/skills-fallback/cc-mcp-use-mcp-servers-from-claude-ai/SKILL.md +35 -0
- package/skills-fallback/cc-mcp-what-you-can-do-with-mcp/SKILL.md +12 -0
- package/skills-fallback/cc-memory/SKILL.md +28 -0
- package/skills-fallback/cc-model-config/SKILL.md +27 -0
- package/skills-fallback/cc-permissions/SKILL.md +38 -0
- package/skills-fallback/cc-plugins/SKILL.md +44 -0
- package/skills-fallback/cc-sandboxing/SKILL.md +22 -0
- package/skills-fallback/cc-scheduled-tasks/SKILL.md +20 -0
- package/skills-fallback/cc-settings-configuration-scopes/SKILL.md +57 -0
- package/skills-fallback/cc-settings-environment-variables/SKILL.md +13 -0
- package/skills-fallback/cc-settings-plugin-configuration/SKILL.md +11 -0
- package/skills-fallback/cc-settings-see-also/SKILL.md +13 -0
- package/skills-fallback/cc-settings-settings-files/SKILL.md +38 -0
- package/skills-fallback/cc-settings-subagent-configuration/SKILL.md +16 -0
- package/skills-fallback/cc-settings-tools-available-to-claude/SKILL.md +13 -0
- package/skills-fallback/cc-skills-guide/SKILL.md +23 -0
- package/skills-fallback/cc-sub-agents/SKILL.md +30 -0
- package/skills-fallback/cc-tutor/SKILL.md +108 -0
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cc-hooks-guide
|
|
3
|
+
description: "Guía práctica de hooks con ejemplos: notificaciones, auto-format, bloquear archivos, re-inyectar contexto, auto-approve."
|
|
4
|
+
invocation: auto
|
|
5
|
+
_pulse: true
|
|
6
|
+
_syncedAt: "2026-04-07T04:44:06.766Z"
|
|
7
|
+
_source: "https://code.claude.com/docs/en/hooks-guide.md"
|
|
8
|
+
---
|
|
9
|
+
> ## Documentation Index
|
|
10
|
+
>
|
|
11
|
+
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
|
|
12
|
+
> Use this file to discover all available pages before exploring further.
|
|
13
|
+
|
|
14
|
+
# Automate workflows with hooks
|
|
15
|
+
|
|
16
|
+
> Run shell commands automatically when Claude Code edits files, finishes tasks, or needs input. Format code, send notifications, validate commands, and enforce project rules.
|
|
17
|
+
|
|
18
|
+
Hooks are user-defined shell commands that execute at specific points in Claude Code's lifecycle. They provide deterministic control over Claude Code's behavior, ensuring certain actions always happen rather than relying on the LLM to choose to run them. Use hooks to enforce project rules, automate repetitive tasks, and integrate Claude Code with your existing tools.
|
|
19
|
+
|
|
20
|
+
For decisions that require judgment rather than deterministic rules, you can also use [prompt-based hooks](#prompt-based-hooks) or [agent-based hooks](#agent-based-hooks) that use a Claude model to evaluate conditions.
|
|
21
|
+
|
|
22
|
+
For other ways to extend Claude Code, see [skills](/en/skills) for giving Claude additional instructions and executable commands, [subagents](/en/sub-agents) for running tasks in isolated contexts, and [plugins](/en/plugins) for packaging extensions to share across projects.
|
|
23
|
+
|
|
24
|
+
## Set up your first hook
|
|
25
|
+
|
|
26
|
+
To create a hook, add a `hooks` block to a [settings file](#configure-hook-location). This walkthrough creates a desktop notification hook, so you get alerted whenever Claude is waiting for your input instead of watching the terminal.
|
|
27
|
+
|
|
28
|
+
````
|
|
29
|
+
```json theme={null}
|
|
30
|
+
{
|
|
31
|
+
"hooks": {
|
|
32
|
+
"Notification": [
|
|
33
|
+
{
|
|
34
|
+
"matcher": "",
|
|
35
|
+
"hooks": [
|
|
36
|
+
{
|
|
37
|
+
"type": "command",
|
|
38
|
+
"command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
|
|
39
|
+
}
|
|
40
|
+
]
|
|
41
|
+
}
|
|
42
|
+
]
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
If your settings file already has a `hooks` key, merge the `Notification` entry into it rather than replacing the whole object. You can also ask Claude to write the hook for you by describing what you want in the CLI.
|
|
48
|
+
````
|
|
49
|
+
|
|
50
|
+
</Step>
|
|
51
|
+
|
|
52
|
+
<Step title="Verify the configuration">
|
|
53
|
+
Type `/hooks` to open the hooks browser. You'll see a list of all available hook events, with a count next to each event that has hooks configured. Select `Notification` to confirm your new hook appears in the list. Selecting the hook shows its details: the event, matcher, type, source file, and command.
|
|
54
|
+
</Step>
|
|
55
|
+
|
|
56
|
+
<Step title="Test the hook">
|
|
57
|
+
Press `Esc` to return to the CLI. Ask Claude to do something that requires permission, then switch away from the terminal. You should receive a desktop notification.
|
|
58
|
+
</Step>
|
|
59
|
+
</Steps>
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cc-hooks-io
|
|
3
|
+
description: "Esquemas JSON de input/output, exit codes, decisiones"
|
|
4
|
+
invocation: auto
|
|
5
|
+
_pulse: true
|
|
6
|
+
_syncedAt: "2026-04-07T04:44:06.766Z"
|
|
7
|
+
_source: "https://code.claude.com/docs/en/hooks.md"
|
|
8
|
+
---
|
|
9
|
+
## Hook input and output
|
|
10
|
+
|
|
11
|
+
Command hooks receive JSON data via stdin and communicate results through exit codes, stdout, and stderr. HTTP hooks receive the same JSON as the POST request body and communicate results through the HTTP response body. This section covers fields and behavior common to all events. Each event's section under [Hook events](#hook-events) includes its specific input schema and decision control options.
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cc-learning-path
|
|
3
|
+
description: "Ruta de aprendizaje estructurada de Claude Code por niveles: beginner, intermediate y advanced. Úsame cuando el usuario quiera ver el currículo completo, saber qué aprender después, o pida un plan de estudio. Invócame con /cc-learning-path."
|
|
4
|
+
invocation: auto
|
|
5
|
+
_pulse: true
|
|
6
|
+
_syncedAt: "2026-04-07T04:44:06.766Z"
|
|
7
|
+
_source: "static"
|
|
8
|
+
---
|
|
9
|
+
# Claude Code — Learning Path
|
|
10
|
+
> Powered by claude-code-tutor · Skills sincronizadas con docs oficiales
|
|
11
|
+
|
|
12
|
+
## Cómo usar esta guía
|
|
13
|
+
Cada nivel incluye conceptos, el skill de referencia disponible en tu sesión,
|
|
14
|
+
y un ejercicio práctico para validar que lo dominaste.
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## Beginner
|
|
19
|
+
|
|
20
|
+
| Tema | Skill de referencia | Ejercicio |
|
|
21
|
+
|---|---|---|
|
|
22
|
+
| Instalación y primer uso | — | Abrir Claude Code en un proyecto real |
|
|
23
|
+
| Permission modes | `cc-permissions` | Alternar entre default y plan mode |
|
|
24
|
+
| CLAUDE.md básico | `cc-memory` | Crear un CLAUDE.md para tu proyecto |
|
|
25
|
+
| Comandos built-in | `cc-commands` | Usar /compact y /cost en una sesión larga |
|
|
26
|
+
| Git workflow | `cc-common-workflows` | Crear un commit y PR con Claude Code |
|
|
27
|
+
|
|
28
|
+
**Checkpoint**: ¿Puedes pedirle a Claude Code que entienda tu codebase
|
|
29
|
+
y haga un cambio con tests en menos de 5 prompts?
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Intermediate
|
|
34
|
+
|
|
35
|
+
| Tema | Skill de referencia | Ejercicio |
|
|
36
|
+
|---|---|---|
|
|
37
|
+
| settings.json completo | `cc-settings` | Configurar permisos fine-grained |
|
|
38
|
+
| Crear una Skill | `cc-skills-guide` | Skill de code review para tu stack |
|
|
39
|
+
| Hook SessionStart | `cc-hooks-events` + `cc-hooks-guide` | Notificación cuando empieza sesión |
|
|
40
|
+
| Hook PostToolUse | `cc-hooks-events` | Auto-format después de editar archivos |
|
|
41
|
+
| MCP server básico | `cc-mcp` | Conectar tu base de datos via MCP |
|
|
42
|
+
| Sub-agents | `cc-sub-agents` | Agente especializado en testing |
|
|
43
|
+
| Worktrees paralelos | `cc-common-workflows` | Dos features en paralelo |
|
|
44
|
+
| Headless en scripts | `cc-headless` | `claude --print` en un npm script |
|
|
45
|
+
|
|
46
|
+
**Checkpoint**: ¿Tienes hooks que automatizan al menos 2 tareas
|
|
47
|
+
repetitivas de tu flujo de desarrollo?
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## Advanced
|
|
52
|
+
|
|
53
|
+
| Tema | Skill de referencia | Ejercicio |
|
|
54
|
+
|---|---|---|
|
|
55
|
+
| Agent teams | `cc-agent-teams` | Equipo de 3 agentes: review, implement, test |
|
|
56
|
+
| Channels + webhooks | `cc-channels` | CI que notifica a sesión activa |
|
|
57
|
+
| Crear un Plugin | `cc-plugins` | Plugin con skills + hooks para tu equipo |
|
|
58
|
+
| GitHub Actions | `cc-github-actions` | @claude en PRs del repo |
|
|
59
|
+
| Sandboxing | `cc-sandboxing` | Habilitar y configurar para el equipo |
|
|
60
|
+
| Model config | `cc-model-config` | opusplan para arquitectura, haiku para tasks rápidas |
|
|
61
|
+
| Scheduled tasks | `cc-scheduled-tasks` | /loop que monitorea deploys |
|
|
62
|
+
|
|
63
|
+
**Checkpoint**: ¿Tienes Claude Code integrado en tu CI/CD y al menos
|
|
64
|
+
un plugin compartido con tu equipo?
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## Skills disponibles en esta sesión
|
|
69
|
+
Todas estas skills están sincronizadas con la documentación oficial:
|
|
70
|
+
`cc-changelog` · `cc-hooks-events` · `cc-hooks-config` · `cc-hooks-io` ·
|
|
71
|
+
`cc-hooks-guide` · `cc-mcp` · `cc-settings` · `cc-permissions` ·
|
|
72
|
+
`cc-sub-agents` · `cc-agent-teams` · `cc-skills-guide` · `cc-memory` ·
|
|
73
|
+
`cc-cli-reference` · `cc-commands` · `cc-model-config` · `cc-plugins` ·
|
|
74
|
+
`cc-channels` · `cc-scheduled-tasks` · `cc-headless` · `cc-sandboxing` ·
|
|
75
|
+
`cc-common-workflows` · `cc-best-practices` · `cc-github-actions`
|
|
76
|
+
|
|
77
|
+
Para ver el estado de sincronización: ejecuta `pulse status` en tu terminal.
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cc-mcp-add-mcp-servers-from-json-configuration
|
|
3
|
+
description: "Configuración de MCP servers en Claude Code: instalar, scopes (local/project/user), autenticación OAuth, tool search, managed MCP, recursos y prompts MCP."
|
|
4
|
+
invocation: auto
|
|
5
|
+
_pulse: true
|
|
6
|
+
_syncedAt: "2026-04-07T04:44:06.766Z"
|
|
7
|
+
_source: "https://code.claude.com/docs/en/mcp.md"
|
|
8
|
+
---
|
|
9
|
+
## Add MCP servers from JSON configuration
|
|
10
|
+
|
|
11
|
+
If you have a JSON configuration for an MCP server, you can add it directly:
|
|
12
|
+
|
|
13
|
+
````
|
|
14
|
+
# Example: Adding an HTTP server with JSON configuration
|
|
15
|
+
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'
|
|
16
|
+
|
|
17
|
+
# Example: Adding a stdio server with JSON configuration
|
|
18
|
+
claude mcp add-json local-weather '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'
|
|
19
|
+
|
|
20
|
+
# Example: Adding an HTTP server with pre-configured OAuth credentials
|
|
21
|
+
claude mcp add-json my-server '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' --client-secret
|
|
22
|
+
```
|
|
23
|
+
````
|
|
24
|
+
|
|
25
|
+
</Step>
|
|
26
|
+
|
|
27
|
+
<Step title="Verify the server was added">
|
|
28
|
+
```bash theme={null}
|
|
29
|
+
claude mcp get weather-api
|
|
30
|
+
```
|
|
31
|
+
</Step>
|
|
32
|
+
</Steps>
|
|
33
|
+
|
|
34
|
+
- Make sure the JSON is properly escaped in your shell
|
|
35
|
+
- The JSON must conform to the MCP server configuration schema
|
|
36
|
+
- You can use `--scope user` to add the server to your user configuration instead of the project-specific one
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cc-mcp-authenticate-with-remote-mcp-servers
|
|
3
|
+
description: "Configuración de MCP servers en Claude Code: instalar, scopes (local/project/user), autenticación OAuth, tool search, managed MCP, recursos y prompts MCP."
|
|
4
|
+
invocation: auto
|
|
5
|
+
_pulse: true
|
|
6
|
+
_syncedAt: "2026-04-07T04:44:06.766Z"
|
|
7
|
+
_source: "https://code.claude.com/docs/en/mcp.md"
|
|
8
|
+
---
|
|
9
|
+
## Authenticate with remote MCP servers
|
|
10
|
+
|
|
11
|
+
Many cloud-based MCP servers require authentication. Claude Code supports OAuth 2.0 for secure connections.
|
|
12
|
+
|
|
13
|
+
````
|
|
14
|
+
```bash theme={null}
|
|
15
|
+
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
|
|
16
|
+
```
|
|
17
|
+
````
|
|
18
|
+
|
|
19
|
+
</Step>
|
|
20
|
+
|
|
21
|
+
<Step title="Use the /mcp command within Claude Code">
|
|
22
|
+
In Claude code, use the command:
|
|
23
|
+
|
|
24
|
+
````
|
|
25
|
+
```text theme={null}
|
|
26
|
+
/mcp
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Then follow the steps in your browser to login.
|
|
30
|
+
````
|
|
31
|
+
|
|
32
|
+
</Step>
|
|
33
|
+
</Steps>
|
|
34
|
+
|
|
35
|
+
- Authentication tokens are stored securely and refreshed automatically
|
|
36
|
+
- Use "Clear authentication" in the `/mcp` menu to revoke access
|
|
37
|
+
- If your browser doesn't open automatically, copy the provided URL and open it manually
|
|
38
|
+
- If the browser redirect fails with a connection error after authenticating, paste the full callback URL from your browser's address bar into the URL prompt that appears in Claude Code
|
|
39
|
+
- OAuth authentication works with HTTP servers
|
|
40
|
+
|
|
41
|
+
### Use a fixed OAuth callback port
|
|
42
|
+
|
|
43
|
+
Some MCP servers require a specific redirect URI registered in advance. By default, Claude Code picks a random available port for the OAuth callback. Use `--callback-port` to fix the port so it matches a pre-registered redirect URI of the form `http://localhost:PORT/callback`.
|
|
44
|
+
|
|
45
|
+
You can use `--callback-port` on its own (with dynamic client registration) or together with `--client-id` (with pre-configured credentials).
|
|
46
|
+
|
|
47
|
+
```bash theme={null}
|
|
48
|
+
# Fixed callback port with dynamic client registration
|
|
49
|
+
claude mcp add --transport http \
|
|
50
|
+
--callback-port 8080 \
|
|
51
|
+
my-server https://mcp.example.com/mcp
|
|
52
|
+
```
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cc-mcp-import-mcp-servers-from-claude-desktop
|
|
3
|
+
description: "Configuración de MCP servers en Claude Code: instalar, scopes (local/project/user), autenticación OAuth, tool search, managed MCP, recursos y prompts MCP."
|
|
4
|
+
invocation: auto
|
|
5
|
+
_pulse: true
|
|
6
|
+
_syncedAt: "2026-04-07T04:44:06.766Z"
|
|
7
|
+
_source: "https://code.claude.com/docs/en/mcp.md"
|
|
8
|
+
---
|
|
9
|
+
## Import MCP servers from Claude Desktop
|
|
10
|
+
|
|
11
|
+
If you've already configured MCP servers in Claude Desktop, you can import them:
|
|
12
|
+
|
|
13
|
+
<Step title="Select which servers to import">
|
|
14
|
+
After running the command, you'll see an interactive dialog that allows you to select which servers you want to import.
|
|
15
|
+
</Step>
|
|
16
|
+
|
|
17
|
+
<Step title="Verify the servers were imported">
|
|
18
|
+
```bash theme={null}
|
|
19
|
+
claude mcp list
|
|
20
|
+
```
|
|
21
|
+
</Step>
|
|
22
|
+
</Steps>
|
|
23
|
+
|
|
24
|
+
- This feature only works on macOS and Windows Subsystem for Linux (WSL)
|
|
25
|
+
- It reads the Claude Desktop configuration file from its standard location on those platforms
|
|
26
|
+
- Use the `--scope user` flag to add servers to your user configuration
|
|
27
|
+
- Imported servers will have the same names as in Claude Desktop
|
|
28
|
+
- If servers with the same names already exist, they will get a numerical suffix (for example, `server_1`)
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cc-mcp-installing-mcp-servers
|
|
3
|
+
description: "Configuración de MCP servers en Claude Code: instalar, scopes (local/project/user), autenticación OAuth, tool search, managed MCP, recursos y prompts MCP."
|
|
4
|
+
invocation: auto
|
|
5
|
+
_pulse: true
|
|
6
|
+
_syncedAt: "2026-04-07T04:44:06.766Z"
|
|
7
|
+
_source: "https://code.claude.com/docs/en/mcp.md"
|
|
8
|
+
---
|
|
9
|
+
## Installing MCP servers
|
|
10
|
+
|
|
11
|
+
MCP servers can be configured in three different ways depending on your needs:
|
|
12
|
+
|
|
13
|
+
### Option 1: Add a remote HTTP server
|
|
14
|
+
|
|
15
|
+
HTTP servers are the recommended option for connecting to remote MCP servers. This is the most widely supported transport for cloud-based services.
|
|
16
|
+
|
|
17
|
+
```bash theme={null}
|
|
18
|
+
# Basic syntax
|
|
19
|
+
claude mcp add --transport http <name> <url>
|
|
20
|
+
|
|
21
|
+
# Real example: Connect to Notion
|
|
22
|
+
claude mcp add --transport http notion https://mcp.notion.com/mcp
|
|
23
|
+
|
|
24
|
+
# Example with Bearer token
|
|
25
|
+
claude mcp add --transport http secure-api https://api.example.com/mcp \
|
|
26
|
+
--header "Authorization: Bearer your-token"
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
### Option 2: Add a remote SSE server
|
|
30
|
+
|
|
31
|
+
```bash theme={null}
|
|
32
|
+
# Basic syntax
|
|
33
|
+
claude mcp add --transport sse <name> <url>
|
|
34
|
+
|
|
35
|
+
# Real example: Connect to Asana
|
|
36
|
+
claude mcp add --transport sse asana https://mcp.asana.com/sse
|
|
37
|
+
|
|
38
|
+
# Example with authentication header
|
|
39
|
+
claude mcp add --transport sse private-api https://api.company.com/sse \
|
|
40
|
+
--header "X-API-Key: your-key-here"
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
### Option 3: Add a local stdio server
|
|
44
|
+
|
|
45
|
+
Stdio servers run as local processes on your machine. They're ideal for tools that need direct system access or custom scripts.
|
|
46
|
+
|
|
47
|
+
```bash theme={null}
|
|
48
|
+
# Basic syntax
|
|
49
|
+
claude mcp add [options] <name> -- <command> [args...]
|
|
50
|
+
|
|
51
|
+
# Real example: Add Airtable server
|
|
52
|
+
claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \
|
|
53
|
+
-- npx -y airtable-mcp-server
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
All options (`--transport`, `--env`, `--scope`, `--header`) must come **before** the server name. The `--` (double dash) then separates the server name from the command and arguments that get passed to the MCP server.
|
|
57
|
+
|
|
58
|
+
For example:
|
|
59
|
+
|
|
60
|
+
- `claude mcp add --transport stdio myserver -- npx server` → runs `npx server`
|
|
61
|
+
- `claude mcp add --transport stdio --env KEY=value myserver -- python server.py --port 8080` → runs `python server.py --port 8080` with `KEY=value` in environment
|
|
62
|
+
|
|
63
|
+
This prevents conflicts between Claude's flags and the server's flags.
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
### Managing your servers
|
|
67
|
+
|
|
68
|
+
Once configured, you can manage your MCP servers with these commands:
|
|
69
|
+
|
|
70
|
+
```bash theme={null}
|
|
71
|
+
# List all configured servers
|
|
72
|
+
claude mcp list
|
|
73
|
+
|
|
74
|
+
# Get details for a specific server
|
|
75
|
+
claude mcp get github
|
|
76
|
+
|
|
77
|
+
# Remove a server
|
|
78
|
+
claude mcp remove github
|
|
79
|
+
|
|
80
|
+
# (within Claude Code) Check server status
|
|
81
|
+
/mcp
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### Dynamic tool updates
|
|
85
|
+
|
|
86
|
+
Claude Code supports MCP `list_changed` notifications, allowing MCP servers to dynamically update their available tools, prompts, and resources without requiring you to disconnect and reconnect. When an MCP server sends a `list_changed` notification, Claude Code automatically refreshes the available capabilities from that server.
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cc-mcp-managed-mcp-configuration
|
|
3
|
+
description: "Configuración de MCP servers en Claude Code: instalar, scopes (local/project/user), autenticación OAuth, tool search, managed MCP, recursos y prompts MCP."
|
|
4
|
+
invocation: auto
|
|
5
|
+
_pulse: true
|
|
6
|
+
_syncedAt: "2026-04-07T04:44:06.766Z"
|
|
7
|
+
_source: "https://code.claude.com/docs/en/mcp.md"
|
|
8
|
+
---
|
|
9
|
+
## Managed MCP configuration
|
|
10
|
+
|
|
11
|
+
For organizations that need centralized control over MCP servers, Claude Code supports two configuration options:
|
|
12
|
+
|
|
13
|
+
1. **Exclusive control with `managed-mcp.json`**: Deploy a fixed set of MCP servers that users cannot modify or extend
|
|
14
|
+
2. **Policy-based control with allowlists/denylists**: Allow users to add their own servers, but restrict which ones are permitted
|
|
15
|
+
|
|
16
|
+
These options allow IT administrators to:
|
|
17
|
+
|
|
18
|
+
- **Control which MCP servers employees can access**: Deploy a standardized set of approved MCP servers across the organization
|
|
19
|
+
- **Prevent unauthorized MCP servers**: Restrict users from adding unapproved MCP servers
|
|
20
|
+
- **Disable MCP entirely**: Remove MCP functionality completely if needed
|
|
21
|
+
|
|
22
|
+
### Option 1: Exclusive control with managed-mcp.json
|
|
23
|
+
|
|
24
|
+
When you deploy a `managed-mcp.json` file, it takes **exclusive control** over all MCP servers. Users cannot add, modify, or use any MCP servers other than those defined in this file. This is the simplest approach for organizations that want complete control.
|
|
25
|
+
|
|
26
|
+
System administrators deploy the configuration file to a system-wide directory:
|
|
27
|
+
|
|
28
|
+
- macOS: `/Library/Application Support/ClaudeCode/managed-mcp.json`
|
|
29
|
+
- Linux and WSL: `/etc/claude-code/managed-mcp.json`
|
|
30
|
+
- Windows: `C:\Program Files\ClaudeCode\managed-mcp.json`
|
|
31
|
+
|
|
32
|
+
The `managed-mcp.json` file uses the same format as a standard `.mcp.json` file:
|
|
33
|
+
|
|
34
|
+
```json theme={null}
|
|
35
|
+
{
|
|
36
|
+
"mcpServers": {
|
|
37
|
+
"github": {
|
|
38
|
+
"type": "http",
|
|
39
|
+
"url": "https://api.githubcopilot.com/mcp/"
|
|
40
|
+
},
|
|
41
|
+
"sentry": {
|
|
42
|
+
"type": "http",
|
|
43
|
+
"url": "https://mcp.sentry.dev/mcp"
|
|
44
|
+
},
|
|
45
|
+
"company-internal": {
|
|
46
|
+
"type": "stdio",
|
|
47
|
+
"command": "/usr/local/bin/company-mcp-server",
|
|
48
|
+
"args": ["--config", "/etc/company/mcp-config.json"],
|
|
49
|
+
"env": {
|
|
50
|
+
"COMPANY_API_URL": "https://internal.company.com"
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
```
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cc-mcp-mcp-installation-scopes
|
|
3
|
+
description: "Configuración de MCP servers en Claude Code: instalar, scopes (local/project/user), autenticación OAuth, tool search, managed MCP, recursos y prompts MCP."
|
|
4
|
+
invocation: auto
|
|
5
|
+
_pulse: true
|
|
6
|
+
_syncedAt: "2026-04-07T04:44:06.766Z"
|
|
7
|
+
_source: "https://code.claude.com/docs/en/mcp.md"
|
|
8
|
+
---
|
|
9
|
+
## MCP installation scopes
|
|
10
|
+
|
|
11
|
+
MCP servers can be configured at three different scope levels, each serving distinct purposes for managing server accessibility and sharing. Understanding these scopes helps you determine the best way to configure servers for your specific needs.
|
|
12
|
+
|
|
13
|
+
### Local scope
|
|
14
|
+
|
|
15
|
+
Local-scoped servers represent the default configuration level and are stored in `~/.claude.json` under your project's path. These servers remain private to you and are only accessible when working within the current project directory. This scope is ideal for personal development servers, experimental configurations, or servers containing sensitive credentials that shouldn't be shared.
|
|
16
|
+
|
|
17
|
+
```bash theme={null}
|
|
18
|
+
# Add a local-scoped server (default)
|
|
19
|
+
claude mcp add --transport http stripe https://mcp.stripe.com
|
|
20
|
+
|
|
21
|
+
# Explicitly specify local scope
|
|
22
|
+
claude mcp add --transport http stripe --scope local https://mcp.stripe.com
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### Project scope
|
|
26
|
+
|
|
27
|
+
Project-scoped servers enable team collaboration by storing configurations in a `.mcp.json` file at your project's root directory. This file is designed to be checked into version control, ensuring all team members have access to the same MCP tools and services. When you add a project-scoped server, Claude Code automatically creates or updates this file with the appropriate configuration structure.
|
|
28
|
+
|
|
29
|
+
```bash theme={null}
|
|
30
|
+
# Add a project-scoped server
|
|
31
|
+
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
The resulting `.mcp.json` file follows a standardized format:
|
|
35
|
+
|
|
36
|
+
```json theme={null}
|
|
37
|
+
{
|
|
38
|
+
"mcpServers": {
|
|
39
|
+
"shared-server": {
|
|
40
|
+
"command": "/path/to/server",
|
|
41
|
+
"args": [],
|
|
42
|
+
"env": {}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
For security reasons, Claude Code prompts for approval before using project-scoped servers from `.mcp.json` files. If you need to reset these approval choices, use the `claude mcp reset-project-choices` command.
|
|
49
|
+
|
|
50
|
+
### User scope
|
|
51
|
+
|
|
52
|
+
User-scoped servers are stored in `~/.claude.json` and provide cross-project accessibility, making them available across all projects on your machine while remaining private to your user account. This scope works well for personal utility servers, development tools, or services you frequently use across different projects.
|
|
53
|
+
|
|
54
|
+
```bash theme={null}
|
|
55
|
+
# Add a user server
|
|
56
|
+
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic
|
|
57
|
+
```
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cc-mcp-mcp-output-limits-and-warnings
|
|
3
|
+
description: "Configuración de MCP servers en Claude Code: instalar, scopes (local/project/user), autenticación OAuth, tool search, managed MCP, recursos y prompts MCP."
|
|
4
|
+
invocation: auto
|
|
5
|
+
_pulse: true
|
|
6
|
+
_syncedAt: "2026-04-07T04:44:06.766Z"
|
|
7
|
+
_source: "https://code.claude.com/docs/en/mcp.md"
|
|
8
|
+
---
|
|
9
|
+
## MCP output limits and warnings
|
|
10
|
+
|
|
11
|
+
When MCP tools produce large outputs, Claude Code helps manage the token usage to prevent overwhelming your conversation context:
|
|
12
|
+
|
|
13
|
+
- **Output warning threshold**: Claude Code displays a warning when any MCP tool output exceeds 10,000 tokens
|
|
14
|
+
- **Configurable limit**: You can adjust the maximum allowed MCP output tokens using the `MAX_MCP_OUTPUT_TOKENS` environment variable
|
|
15
|
+
- **Default limit**: The default maximum is 25,000 tokens
|
|
16
|
+
|
|
17
|
+
To increase the limit for tools that produce large outputs:
|
|
18
|
+
|
|
19
|
+
```bash theme={null}
|
|
20
|
+
export MAX_MCP_OUTPUT_TOKENS=50000
|
|
21
|
+
claude
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
This is particularly useful when working with MCP servers that:
|
|
25
|
+
|
|
26
|
+
- Query large datasets or databases
|
|
27
|
+
- Generate detailed reports or documentation
|
|
28
|
+
- Process extensive log files or debugging information
|
|
29
|
+
|
|
30
|
+
### Override result size per tool
|
|
31
|
+
|
|
32
|
+
If you're building an MCP server, you can allow individual tools to return results larger than the default persist-to-disk threshold by setting `_meta["anthropic/maxResultSizeChars"]` in the tool's `tools/list` response entry. Claude Code raises that tool's threshold to the annotated value, up to a hard ceiling of 500,000 characters.
|
|
33
|
+
|
|
34
|
+
This is useful for tools that return inherently large but necessary outputs, such as database schemas or full file trees. Without the annotation, results that exceed the default threshold are persisted to disk and replaced with a file reference in the conversation.
|
|
35
|
+
|
|
36
|
+
```json theme={null}
|
|
37
|
+
{
|
|
38
|
+
"name": "get_schema",
|
|
39
|
+
"description": "Returns the full database schema",
|
|
40
|
+
"_meta": {
|
|
41
|
+
"anthropic/maxResultSizeChars": 500000
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
The annotation raises the per-tool persist threshold but does not bypass the global `MAX_MCP_OUTPUT_TOKENS` limit, which defaults to 25,000 tokens or roughly 100,000 characters. To return results larger than that, users must also raise `MAX_MCP_OUTPUT_TOKENS`.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cc-mcp-popular-mcp-servers
|
|
3
|
+
description: "Configuración de MCP servers en Claude Code: instalar, scopes (local/project/user), autenticación OAuth, tool search, managed MCP, recursos y prompts MCP."
|
|
4
|
+
invocation: auto
|
|
5
|
+
_pulse: true
|
|
6
|
+
_syncedAt: "2026-04-07T04:44:06.766Z"
|
|
7
|
+
_source: "https://code.claude.com/docs/en/mcp.md"
|
|
8
|
+
---
|
|
9
|
+
## Popular MCP servers
|
|
10
|
+
|
|
11
|
+
Here are some commonly used MCP servers you can connect to Claude Code:
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cc-mcp-practical-examples
|
|
3
|
+
description: "Configuración de MCP servers en Claude Code: instalar, scopes (local/project/user), autenticación OAuth, tool search, managed MCP, recursos y prompts MCP."
|
|
4
|
+
invocation: auto
|
|
5
|
+
_pulse: true
|
|
6
|
+
_syncedAt: "2026-04-07T04:44:06.766Z"
|
|
7
|
+
_source: "https://code.claude.com/docs/en/mcp.md"
|
|
8
|
+
---
|
|
9
|
+
## Practical examples
|
|
10
|
+
|
|
11
|
+
{/\* ### Example: Automate browser testing with Playwright
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
claude mcp add --transport stdio playwright -- npx -y @playwright/mcp@latest
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
Then write and run browser tests:
|
|
18
|
+
|
|
19
|
+
```text
|
|
20
|
+
Test if the login flow works with test@example.com
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
```text
|
|
24
|
+
Take a screenshot of the checkout page on mobile
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
````text
|
|
28
|
+
Verify that the search feature returns results
|
|
29
|
+
``` */}
|
|
30
|
+
|
|
31
|
+
### Example: Monitor errors with Sentry
|
|
32
|
+
|
|
33
|
+
```bash theme={null}
|
|
34
|
+
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
|
|
35
|
+
````
|
|
36
|
+
|
|
37
|
+
Authenticate with your Sentry account:
|
|
38
|
+
|
|
39
|
+
```text theme={null}
|
|
40
|
+
/mcp
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Then debug production issues:
|
|
44
|
+
|
|
45
|
+
```text theme={null}
|
|
46
|
+
What are the most common errors in the last 24 hours?
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
```text theme={null}
|
|
50
|
+
Show me the stack trace for error ID abc123
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
```text theme={null}
|
|
54
|
+
Which deployment introduced these new errors?
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### Example: Connect to GitHub for code reviews
|
|
58
|
+
|
|
59
|
+
```bash theme={null}
|
|
60
|
+
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Authenticate if needed by selecting "Authenticate" for GitHub:
|
|
64
|
+
|
|
65
|
+
```text theme={null}
|
|
66
|
+
/mcp
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Then work with GitHub:
|
|
70
|
+
|
|
71
|
+
```text theme={null}
|
|
72
|
+
Review PR #456 and suggest improvements
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
```text theme={null}
|
|
76
|
+
Create a new issue for the bug we just found
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
```text theme={null}
|
|
80
|
+
Show me all open PRs assigned to me
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### Example: Query your PostgreSQL database
|
|
84
|
+
|
|
85
|
+
```bash theme={null}
|
|
86
|
+
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
|
|
87
|
+
--dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Then query your database naturally:
|
|
91
|
+
|
|
92
|
+
```text theme={null}
|
|
93
|
+
What's our total revenue this month?
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
```text theme={null}
|
|
97
|
+
Show me the schema for the orders table
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
```text theme={null}
|
|
101
|
+
Find customers who haven't made a purchase in 90 days
|
|
102
|
+
```
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cc-mcp-respond-to-mcp-elicitation-requests
|
|
3
|
+
description: "Configuración de MCP servers en Claude Code: instalar, scopes (local/project/user), autenticación OAuth, tool search, managed MCP, recursos y prompts MCP."
|
|
4
|
+
invocation: auto
|
|
5
|
+
_pulse: true
|
|
6
|
+
_syncedAt: "2026-04-07T04:44:06.766Z"
|
|
7
|
+
_source: "https://code.claude.com/docs/en/mcp.md"
|
|
8
|
+
---
|
|
9
|
+
## Respond to MCP elicitation requests
|
|
10
|
+
|
|
11
|
+
MCP servers can request structured input from you mid-task using elicitation. When a server needs information it can't get on its own, Claude Code displays an interactive dialog and passes your response back to the server. No configuration is required on your side: elicitation dialogs appear automatically when a server requests them.
|
|
12
|
+
|
|
13
|
+
Servers can request input in two ways:
|
|
14
|
+
|
|
15
|
+
- **Form mode**: Claude Code shows a dialog with form fields defined by the server (for example, a username and password prompt). Fill in the fields and submit.
|
|
16
|
+
- **URL mode**: Claude Code opens a browser URL for authentication or approval. Complete the flow in the browser, then confirm in the CLI.
|
|
17
|
+
|
|
18
|
+
To auto-respond to elicitation requests without showing a dialog, use the [`Elicitation` hook](/en/hooks#elicitation).
|
|
19
|
+
|
|
20
|
+
If you're building an MCP server that uses elicitation, see the [MCP elicitation specification](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation) for protocol details and schema examples.
|