SETUP · IA · 5 MIN

Conecte seu primeiro MCP ao Claude Code

Você pede ao Claude Code algo que vive em outro serviço, tipo "acha isso pra mim no meu Notion", e de repente ele consegue. Você não programou a conexão: você plugou um MCP. É assim que você dá ferramentas novas pra ele com uma linha.

Para: quem já usa o Claude Code e quer ampliar o alcance dele
Precisa: Claude Code instalado e uma conta no serviço que você vai conectar
Tempo: 5 minutos

MCP é a sigla de Model Context Protocol, mas esquece o nome. Na prática, um MCP é uma tomada: ele entrega ao Claude Code um conjunto novo de ferramentas de um serviço de fora. Sem um MCP, o Claude trabalha com seus arquivos e o terminal. Com um MCP do Notion, ele também lê e escreve no seu Notion. Com um pro seu banco de dados, ele consegue consultar. Você conecta uma vez.

Conecte um remoto (o jeito mais fácil)

MCPs remotos são o ponto de partida mais simples: você não instala nada, só aponta pra um endereço. O comando é claude mcp add, você diz que o transporte é http, dá um nome e cola a URL do serviço. Pro Notion, fica assim:

claude mcp add --transport http notion https://mcp.notion.com/mcp

Isso registra o MCP, mas você ainda não deu permissão pra ele chegar na sua conta. Esse é o próximo passo.

Dê acesso à sua conta

Abra o Claude Code num projeto e digite /mcp. Você vai ver o servidor que acabou de adicionar; escolha ele e o navegador abre pra você logar no serviço. Confirme, e está conectado.

/mcp

Confirme que está conectado

Esse mesmo /mcp mostra o status: cada servidor, se está conectado, e quantas ferramentas ele traz. Pelo terminal você também consegue listar:

claude mcp list
notion: connected

A partir daí, peça algo que use o serviço, em linguagem natural: "resume minha página de tarefas no Notion". O Claude vai buscar as ferramentas do MCP por conta própria.

Só neste projeto, ou em todos?

Por padrão, o MCP fica disponível só no projeto onde você adicionou. Se você quer em todo projeto, adicione -s user (de "user", a sua conta):

claude mcp add -s user --transport http notion https://mcp.notion.com/mcp

Comandos que você vai usar

claude mcp list. Lista todo MCP que você tem e se está conectado.
claude mcp get notion. Mostra os detalhes de um específico.
claude mcp remove notion. Remove quando você não precisa mais.

É isso. Um MCP é como o Claude Code deixa de ficar preso dentro da sua pasta e começa a tocar nas ferramentas que você usa de verdade. O Notion foi o exemplo; o catálogo é enorme.

FEITO PELO EDRA

Eu construo sites, automações e ferramentas de IA, e escrevo o que aprendo no caminho.

Mais tutoriais ↗