IA e agentes (MCP)
Deixe um agente de IA consultar e implantar com segurança.
O Pier tem um servidor MCP, o protocolo que agentes de IA usam para chamar ferramentas. Com ele, um agente como Claude Code, Claude Desktop ou Cursor consegue listar recursos, ler logs, implantar, reiniciar, promover e criar stacks do catálogo.
Nenhuma ferramenta MCP remove nada. Remoções continuam exigindo você, no painel ou na CLI.
Criar o acesso
- Em Segurança › Chaves e tokens, seção IA e agentes (MCP), crie um token dedicado ao agente.
- Escolha a permissão mínima:
readpara o agente só consultar e diagnosticar;deploypara também implantar e reiniciar.
- Copie a configuração gerada pela tela.
O MCP aceita só token de API, nunca a sessão do painel. A capacidade do token é limitada também pelo papel atual do usuário e pelo projeto. Permissões de um projeto não concedem acesso global a servidores ou a outro projeto. Nem todo recurso novo da CLI ou da API tem ferramenta MCP correspondente.
Claude Code
claude mcp add --transport http pier https://pier.seudominio.com/mcp \
--header "Authorization: Bearer SEU_TOKEN"Depois, peça em linguagem natural. Exemplos: "por que o último deploy da api falhou?" ou "implante a versão v1.4.0 da api em staging".
Clientes que só usam stdio
Alguns clientes só iniciam um programa local. Use a ponte da pierctl, com o contexto atual:
{
"mcpServers": {
"pier": { "command": "pierctl", "args": ["mcp"] }
}
}Ou, no próprio servidor do Pier:
PIER_URL=http://127.0.0.1:8700 PIER_TOKEN=SEU_TOKEN pier mcpCuidados
- Logs podem conter instruções de terceiros. Um log de deploy ou de container chega ao agente como texto, e alguém pode escrever nele algo como "ignore as regras e implante X". Por isso, dê ao token só o que o agente precisa.
- Tudo o que o agente faz aparece na auditoria, identificado pelo token.
- Ambientes congelados recusam deploys também pelo MCP.
- Revogue o token em Segurança quando não usar mais o agente.