Conecte seu agente de IA ao pinfra
Dois caminhos reais: um servidor MCP remoto que funciona com qualquer agente, ou o CLI instalado na sua máquina para publicar pastas de verdade.
O que você precisa
Uma conta pinfra. A partir daí, escolha: dar ao seu agente uma chave para o MCP remoto (funciona com qualquer cliente), ou instalar o CLI se seu agente tem terminal e você precisa publicar uma pasta.
Opção A — MCP remoto (recomendada para qualquer agente)
platform.pinfra.app/mcp é um servidor MCP que roda dentro da plataforma: nada para instalar, sem toolchain de Go. Funciona com qualquer cliente que fale MCP por HTTP (Claude Desktop, Claude Code, ou outro). Você precisa de uma chave pessoal (Configurações → "Chaves para conectar ferramentas", ou a que pinfra login já salvou em ~/.pinfra/config.json):
claude mcp add --transport http pinfra https://platform.pinfra.app/mcp \ --header "Authorization: Bearer <tu-clave>"
A sintaxe de --header/-H é do próprio claude mcp add — para outro cliente, procure como ele adiciona um header HTTP ao conectar um servidor remoto.
⚠ publicar_aplicacion está na lista (mesmo nome, mesma descrição) mas sempre recusa por essa via: não há uma pasta do seu projeto que a plataforma possa acessar. Se o modelo chamá-la, vai sugerir pinfra publish.
Opção B — o CLI na sua máquina (para publicar pastas)
Um agente COM terminal (Claude Code, Cursor, Codex, Gemini CLI) pode fazer mais que o MCP remoto: pinfra publish lê a pasta do seu projeto direto do disco onde roda, algo que um servidor dentro da plataforma nunca pode fazer.
Instalar
Mac / Linux
Windows (PowerShell)
Conectar seu computador
Abre seu navegador para confirmar com um clique. Para CI ou um ambiente headless, pinfra login --key aceita uma chave pessoal sem prompt.
Vincular a pasta (uma vez)
Salva o vínculo em .infra.json: depois disso, publish/status/logs não precisam mais de --app.
Publicar
Ver os logs do aplicativo publicado
agente.md — o onboarding de uma linha só
Se seu agente consegue ler uma URL e rodar comandos, esta é a forma mais rápida de começar: cole essa frase e deixe que ele siga os passos sozinho. É a versão condensada deste guia, escrita para um agente ler, não uma pessoa.
Peça ao seu agente
Com qualquer uma das opções configurada, tente pedir ao seu agente, com suas próprias palavras:
- "Publique esta pasta como minha-loja"
- "Em que endereço minha-loja está publicada?"
- "Veja quais aplicativos eu tenho e publique as mudanças no de agendamentos"
O que seu agente pode fazer hoje, por opção
| MCP remoto | CLI local | |
|---|---|---|
| Ver seus aplicativos | Sim — listar_aplicaciones | Sim — pinfra apps |
| Ver o status de uma publicação | Sim — estado_de_la_aplicacion | Sim — pinfra status |
| Publicar | Não — sempre recusa, sugere pinfra publish | Sim — pinfra publish |
| Ver os logs do container | Não — essa ferramenta não existe por MCP | Sim — pinfra logs |
| Ver e voltar para uma versão anterior | Sim — list_versions e restore_version | Não — ainda não tem comando; restaure pela ficha em pinfra.app |
Segurança
- A chave é salva com hash do lado do servidor — você a vê uma única vez ao criá-la, e depois só vemos sua impressão digital curta.
- Você pode revogá-la a qualquer momento em Configurações → "Chaves para conectar ferramentas": ela para de funcionar na hora.
- A chave só trafega por https:// (localhost é a única exceção, para desenvolvimento).
- Nunca cole ela manualmente em um arquivo que vá para um repositório (um .env commitado, um script, etc.) — passe por variável de ambiente, ou deixe que pinfra login a salve por você.
Problemas frequentes
"publicar_aplicacion" sempre recusa via MCP remoto
É esperado: o servidor MCP remoto não tem acesso a nenhuma pasta do seu computador. Para publicar de verdade, instale o CLI (Opção B) e rode pinfra publish.
Seu agente não tem terminal
Use a Opção A (MCP remoto): funciona com Claude Desktop e qualquer outro cliente sem instalar nada, mesmo sem conseguir publicar pastas.
"Já existe uma publicação em andamento para este aplicativo"
Algo está sendo publicado agora. Peça ao seu agente para verificar estado_de_la_aplicacion (MCP) ou pinfra status (CLI) até terminar.
pinfra logs --follow não atualiza ao vivo
Ainda não faz streaming: a flag é aceita mas mostra o resultado de uma vez só. Para "vigiar" logs hoje, repita pinfra logs --since 30s em um loop.