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.
Files changed (70) hide show
  1. package/README.md +315 -0
  2. package/dist/chunk-A6ZZXTHB.js +65 -0
  3. package/dist/chunk-OYDUGORC.js +75 -0
  4. package/dist/cli.js +1362 -0
  5. package/dist/meta-TZOSLFST.js +13 -0
  6. package/dist/tutor-memory-M6GNB3LQ.js +19 -0
  7. package/package.json +61 -0
  8. package/skills-fallback/cc-agent-teams/SKILL.md +38 -0
  9. package/skills-fallback/cc-best-practices/SKILL.md +34 -0
  10. package/skills-fallback/cc-changelog/SKILL.md +20 -0
  11. package/skills-fallback/cc-channels/SKILL.md +34 -0
  12. package/skills-fallback/cc-cli-reference/SKILL.md +16 -0
  13. package/skills-fallback/cc-commands/SKILL.md +12 -0
  14. package/skills-fallback/cc-common-workflows-ask-claude-about-its-capabilities/SKILL.md +43 -0
  15. package/skills-fallback/cc-common-workflows-create-pull-requests/SKILL.md +26 -0
  16. package/skills-fallback/cc-common-workflows-fix-bugs-efficiently/SKILL.md +30 -0
  17. package/skills-fallback/cc-common-workflows-get-notified-when-claude-needs-your-attention/SKILL.md +95 -0
  18. package/skills-fallback/cc-common-workflows-handle-documentation/SKILL.md +36 -0
  19. package/skills-fallback/cc-common-workflows-next-steps/SKILL.md +22 -0
  20. package/skills-fallback/cc-common-workflows-refactor-code/SKILL.md +36 -0
  21. package/skills-fallback/cc-common-workflows-reference-files-and-directories/SKILL.md +47 -0
  22. package/skills-fallback/cc-common-workflows-resume-previous-conversations/SKILL.md +57 -0
  23. package/skills-fallback/cc-common-workflows-run-claude-on-a-schedule/SKILL.md +22 -0
  24. package/skills-fallback/cc-common-workflows-run-parallel-claude-code-sessions-with-git-worktrees/SKILL.md +43 -0
  25. package/skills-fallback/cc-common-workflows-understand-new-codebases/SKILL.md +81 -0
  26. package/skills-fallback/cc-common-workflows-use-claude-as-a-unix-style-utility/SKILL.md +83 -0
  27. package/skills-fallback/cc-common-workflows-use-extended-thinking-thinking-mode/SKILL.md +15 -0
  28. package/skills-fallback/cc-common-workflows-use-plan-mode-for-safe-code-analysis/SKILL.md +80 -0
  29. package/skills-fallback/cc-common-workflows-use-specialized-subagents/SKILL.md +69 -0
  30. package/skills-fallback/cc-common-workflows-work-with-images/SKILL.md +71 -0
  31. package/skills-fallback/cc-common-workflows-work-with-tests/SKILL.md +36 -0
  32. package/skills-fallback/cc-github-actions/SKILL.md +44 -0
  33. package/skills-fallback/cc-headless/SKILL.md +40 -0
  34. package/skills-fallback/cc-hooks-config/SKILL.md +32 -0
  35. package/skills-fallback/cc-hooks-events/SKILL.md +24 -0
  36. package/skills-fallback/cc-hooks-guide/SKILL.md +59 -0
  37. package/skills-fallback/cc-hooks-io/SKILL.md +11 -0
  38. package/skills-fallback/cc-learning-path/SKILL.md +77 -0
  39. package/skills-fallback/cc-mcp-add-mcp-servers-from-json-configuration/SKILL.md +36 -0
  40. package/skills-fallback/cc-mcp-authenticate-with-remote-mcp-servers/SKILL.md +52 -0
  41. package/skills-fallback/cc-mcp-import-mcp-servers-from-claude-desktop/SKILL.md +28 -0
  42. package/skills-fallback/cc-mcp-installing-mcp-servers/SKILL.md +86 -0
  43. package/skills-fallback/cc-mcp-managed-mcp-configuration/SKILL.md +55 -0
  44. package/skills-fallback/cc-mcp-mcp-installation-scopes/SKILL.md +57 -0
  45. package/skills-fallback/cc-mcp-mcp-output-limits-and-warnings/SKILL.md +46 -0
  46. package/skills-fallback/cc-mcp-popular-mcp-servers/SKILL.md +11 -0
  47. package/skills-fallback/cc-mcp-practical-examples/SKILL.md +102 -0
  48. package/skills-fallback/cc-mcp-respond-to-mcp-elicitation-requests/SKILL.md +20 -0
  49. package/skills-fallback/cc-mcp-scale-with-mcp-tool-search/SKILL.md +29 -0
  50. package/skills-fallback/cc-mcp-use-claude-code-as-an-mcp-server/SKILL.md +59 -0
  51. package/skills-fallback/cc-mcp-use-mcp-prompts-as-commands/SKILL.md +40 -0
  52. package/skills-fallback/cc-mcp-use-mcp-resources/SKILL.md +45 -0
  53. package/skills-fallback/cc-mcp-use-mcp-servers-from-claude-ai/SKILL.md +35 -0
  54. package/skills-fallback/cc-mcp-what-you-can-do-with-mcp/SKILL.md +12 -0
  55. package/skills-fallback/cc-memory/SKILL.md +28 -0
  56. package/skills-fallback/cc-model-config/SKILL.md +27 -0
  57. package/skills-fallback/cc-permissions/SKILL.md +38 -0
  58. package/skills-fallback/cc-plugins/SKILL.md +44 -0
  59. package/skills-fallback/cc-sandboxing/SKILL.md +22 -0
  60. package/skills-fallback/cc-scheduled-tasks/SKILL.md +20 -0
  61. package/skills-fallback/cc-settings-configuration-scopes/SKILL.md +57 -0
  62. package/skills-fallback/cc-settings-environment-variables/SKILL.md +13 -0
  63. package/skills-fallback/cc-settings-plugin-configuration/SKILL.md +11 -0
  64. package/skills-fallback/cc-settings-see-also/SKILL.md +13 -0
  65. package/skills-fallback/cc-settings-settings-files/SKILL.md +38 -0
  66. package/skills-fallback/cc-settings-subagent-configuration/SKILL.md +16 -0
  67. package/skills-fallback/cc-settings-tools-available-to-claude/SKILL.md +13 -0
  68. package/skills-fallback/cc-skills-guide/SKILL.md +23 -0
  69. package/skills-fallback/cc-sub-agents/SKILL.md +30 -0
  70. 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.