puxadinho
Criar conta

Conectar o MCP

O MCP é o jeito que o Claude Code e o Codex falam com o puxadinho. Ele fica em https://www.usepuxadinho.com.br/mcp e dá ao agente 19 ferramentas para criar boxes, rodar comandos e trocar arquivos

O jeito mais rápido

Um comando entra na sua conta, cria a chave do agente e registra o MCP:

Claude Code
$ PUXADINHO_API_URL=https://www.usepuxadinho.com.br npx puxadinho@latest setup claude
Codex
$ PUXADINHO_API_URL=https://www.usepuxadinho.com.br npx puxadinho@latest setup codex

O setup também instala a skill do puxadinho. Para só registrar o MCP, sem a skill, use puxadinho mcp init claude ou puxadinho mcp init codex. Depois, reinicie o agente.

Antes de conectar à mão: a chave

O MCP hospedado pede uma chave de API do workspace, que começa com pxd_live_. Crie no painel, em Conectar → Para quem usa outro agente ou automação, ou pela CLI, depois do puxadinho login:

Terminal
$ PUXADINHO_API_URL=https://www.usepuxadinho.com.br puxadinho keys create --name claude --scope boxes:read --scope boxes:write --scope boxes:delete --scope boxes:exec --scope images:write --scope images:read

O valor aparece uma vez só. Criar chaves pede papel de dono ou admin no workspace. Esses escopos são os que as ferramentas do MCP usam; veja o que cada um libera em Chaves e segurança.

Claude Code

Terminal
$ claude mcp add --transport http --scope user puxadinho https://www.usepuxadinho.com.br/mcp --header "Authorization: Bearer pxd_live_SUA_CHAVE"

Troque pxd_live_SUA_CHAVE pela chave. Com --scope user o puxadinho fica disponível em todos os seus projetos. Reinicie o Claude Code e confira com /mcp.

Codex

Cole no fim de ~/.codex/config.toml:

~/.codex/config.toml
[mcp_servers.puxadinho]
url = "https://www.usepuxadinho.com.br/mcp"
http_headers = { Authorization = "Bearer pxd_live_SUA_CHAVE" }

O arquivo guarda a chave: deixe ele só para você (chmod 600 ~/.codex/config.toml). Reinicie o Codex.

MCP local pela CLI

Prefere não deixar a chave na configuração do agente? A CLI roda um MCP local (stdio) com as mesmas ferramentas do hospedado e usa a credencial do seu puxadinho login.

  1. Instale a CLI e entre
    Terminal
    $ npm i -g puxadinho$ PUXADINHO_API_URL=https://www.usepuxadinho.com.br puxadinho login
  2. Registre no agente

    Claude Code

    Terminal
    $ claude mcp add --scope user puxadinho --env PUXADINHO_API_URL=https://www.usepuxadinho.com.br -- puxadinho mcp start

    Codex

    ~/.codex/config.toml
    [mcp_servers.puxadinho]
command = "puxadinho"
args = ["mcp", "start"]
env = { PUXADINHO_API_URL = "https://www.usepuxadinho.com.br" }
Sem login, o MCP local também aceita a chave em PUXADINHO_API_KEY. Sem nenhuma das duas, ele avisa: Sem credencial. Rode "puxadinho login" ou defina PUXADINHO_API_KEY.

Cuidados

  • O claude mcp add --header deixa a chave visível por um instante na lista de processos da máquina. Numa máquina compartilhada, prefira o MCP local.
  • Trocou de chave? Rode o setup de novo: ele registra a nova e revoga as antigas do MCP com o mesmo nome.
  • Revogue uma chave a qualquer hora em Conectar ou com puxadinho keys rm ID_DA_CHAVE.