Qualquer cliente MCP

Um servidor hospedado

O servidor está hospedado em https://mcp.foir.dev/mcp e fala Streamable HTTP. Cada ferramenta chama as mesmas RPCs da plataforma que o console e a CLI usam, então a validação e o escopo por linha ficam com a plataforma. As gravações de registros chegam como rascunhos em modelos com publicação ativada, e publicar e excluir são ferramentas separadas. Seu agente traz o próprio modelo, então conectá-lo não gasta créditos de IA.

Duas formas de autenticar

A primeira é fazer login. Adicione a URL do servidor ao seu cliente, e o primeiro uso abre uma tela de consentimento do Fóir no navegador, onde você concede acesso até o seu próprio nível. O agente então age como você.

A segunda é uma chave secreta de API, que serve para CI e jobs sem supervisão. foir mcp executa um proxy local para o servidor hospedado e usa a chave em FOIR_API_KEY quando uma está definida. O alcance do agente é então o dos escopos da própria chave. Uma chave pública é recusada.

O que um agente logado pode alcançar

Depois do login, o token do agente só consegue descobrir aquilo a que você tem acesso. Ele precisa entrar em um workspace e, opcionalmente, em um projeto e em uma organização, o que emite um token de trabalho com as suas permissões efetivas ali. Os tokens de trabalho duram 30 minutos e são emitidos de novo, e o workspace e o projeto não podem ser escolhidos por chamada.

A lista de ferramentas é filtrada a cada requisição pelo que a credencial possui, então duas pessoas que conectam o mesmo agente ao mesmo projeto podem receber ferramentas diferentes.

Conexões somente leitura

Marque Somente leitura na tela de consentimento e o agente recebe apenas ferramentas de leitura. O consentimento é o teto, seja o que for que o agente leia depois, então uma instrução escondida no conteúdo não pode transformar uma concessão somente de leitura em uma gravação. O proxy da CLI tem uma flag equivalente para uma sessão com login. Ela não consegue restringir uma chave.