mcp-handbook
Skill0 starsChanged 4 months agoMITView on GitHub
Conhecimento sobre o Model Context Protocol (MCP) destilado de dois cursos da Anthropic Academy (Introduction to MCP + Advanced Topics). Use quando precisar entender ou implementar MCP: o par MCP client/server, os primitivos tools, resources e prompts, alem de sampling, roots, log/progress notifications, JSON-RPC e os transports (stdio, StreamableHTTP, stateless HTTP). Gatilhos: "como funciona MCP", "diferenca entre tools/resources/prompts", "o que e sampling/roots", "por que sampling/notifications quebram no StreamableHTTP", "stateless HTTP e session id".
In this repository17 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- agent-skills-and-subagentsSkill
- anthropic-api-handbookSkill
- app-to-cliSkill
- claude-code-handbookSkill
- docs-to-skillSkill
- install-skillSkill
- session-handoffSkill
- site-endpoint-scanSkill
- site-to-cliSkill
- skill-evalSkill
- skilljar-transcriptsSkill
- skill-lintSkill
- skill-prospectorSkill
- skill-scoutSkill
- ui-reskinSkill
- video-curriculumSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 29
Um MCP server desloca o trabalho de definir e rodar tools: do seu codigo para um processo separado — ele funciona como uma …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
MCP Handbook
Corpus consultavel sobre o Model Context Protocol (MCP), destilado das transcricoes de dois cursos da Anthropic Academy. Recorra a ele para entender o modelo mental do MCP e para implementar um MCP server/client (tools, resources, prompts, sampling, roots, notifications) e escolher o transport certo (stdio vs StreamableHTTP vs stateless HTTP).
Conceitos centrais
MCP e uma camada de comunicacao que da ao Claude contexto e tools sem obrigar o desenvolvedor a escrever (e manter) muito codigo de integracao tedioso. Tem dois elementos principais: o client e o server; o server hospeda tools, resources e prompts.
Fonte: introduction-to-model-context-protocol--documento-de-estudo.md › Introducing MCP
Um MCP server desloca o trabalho de definir e rodar tools do seu codigo para um processo separado — ele funciona como uma interface/wrapper de um servico externo (ex.: um GitHub MCP server). MCP e tool use sao complementares, nao a mesma coisa: o MCP server muda quem autora e executa a tool, nao elimina tool use.
Fonte: introduction-to-model-context-protocol--documento-de-estudo.md › Introducing MCP
MCP e transport agnostic e a comunicacao se da por mensagens definidas na MCP spec (ex.: list tools request/result, call tool request/result). O client e o ponto de acesso do seu codigo a tudo que o MCP server expoe.
Fonte: introduction-to-model-context-protocol--documento-de-estudo.md › MCP Clients
Os tres primitivos do server tem controladores distintos: tools sao model controlled (o Claude decide quando rodar), resources sao app controlled (o codigo do app busca dados, ex.: autocomplete/UI) e prompts sao user controlled (o usuario dispara, ex.: slash command).
Fonte: introduction-to-model-context-protocol--documento-de-estudo.md › MCP Review
Sampling deixa o server pedir ao client (que ja fala com o Claude) para rodar um prompt em seu nome — assim o server nao precisa de API key nem paga tokens, ideal para servers publicos. Roots deixam o usuario conceder ao server acesso a um conjunto de files/folders.
Fonte: model-context-protocol-advanced-topics--documento-de-estudo.md › Sampling
O StreamableHTTP permite servers remotos, mas como em HTTP puro o server nao inicia requests para o client, recursos que dependem disso (sampling, progress/log notifications) exigem um workaround com SSE e session id — e os flags stateless HTTP / JSON response podem quebra-los.
Fonte: model-context-protocol-advanced-topics--documento-de-estudo.md › The StreamableHTTP Transport
Topic Index
| Pergunta / termo | Onde |
| O que e MCP, MCP server vs API direta, MCP vs tool use | references/fundamentos-mcp.md |
| Fluxo completo client ↔ server ↔ Claude (list/call tool) | references/fundamentos-mcp.md |
| Quem controla cada primitivo (tools/resources/prompts) | references/fundamentos-mcp.md |
| Definir tools com o MCP Python SDK; Server Inspector | references/tools-resources-prompts.md |
| Implementar um MCP client (ClientSession, list/call tool) | references/tools-resources-prompts.md |
| Resources: URI, MIME type, direct vs templated | references/tools-resources-prompts.md |
| Prompts: slash commands, mensagens, argumentos | references/tools-resources-prompts.md |
| O que e sampling e como configurar (create message + callback) | references/recursos-avancados.md |
| Log e progress notifications (context, callbacks) | references/recursos-avancados.md |
| Roots: conceder acesso a files/folders, list_roots | references/recursos-avancados.md |
| JSON message types, JSON-RPC, schema.ts, request/result vs notification | references/transportes-e-mensagens.md |
| stdio transport e o handshake de initialization | references/transportes-e-mensagens.md |
| StreamableHTTP, SSE, session id, os flags que quebram features | references/transportes-e-mensagens.md |
| stateless HTTP e JSON response (horizontal scaling) | references/transportes-e-mensagens.md |
Referencias (quando ler cada uma)
- references/fundamentos-mcp.md — o modelo mental do MCP: o problema que resolve, MCP server como wrapper de servico, o fluxo completo entre client/server/Claude, o projeto-exemplo (CLI chatbot) e o recap de quem controla tools, resources e prompts. Leia primeiro.
- references/tools-resources-prompts.md — como implementar os tres primitivos com o MCP
Python SDK e o MCP client: decorators
@mcp.tool/@mcp.resource/@mcp.prompt, o Server Inspector, ClientSession, URIs/MIME types e slash commands. Leia ao codar o server/client. - references/recursos-avancados.md — recursos avancados do server→client: sampling, log e progress notifications e roots. Leia ao construir servers publicos ou que tocam o filesystem.
- references/transportes-e-mensagens.md — o formato das mensagens (JSON-RPC, schema.ts) e os transports stdio, StreamableHTTP e stateless HTTP. Leia ao decidir como hospedar/deployar.
Escopo e limites
- Cobre apenas o que esta nas transcricoes dos dois cursos; varias aulas de texto/leitura na plataforma (Welcome, Final assessment, Sampling/Notifications/Roots walkthroughs, Survey, Wrapping up) nao tem transcript, entao seus detalhes nao estao destilados aqui.
- Os exemplos de codigo sao do MCP Python SDK e de um projeto didatico (documentos fake em memoria); use a MCP spec oficial e a doc do SDK para assinaturas exatas e edge cases.
- Nao e referencia de API linha-a-linha nem cobre outros SDKs (TypeScript etc.) em detalhe.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.