Constrói com o VULK a partir do Claude e de outros clientes MCP: o conector, ferramenta a ferramenta

Verificado a 10 de outubro de 2026, contra o servidor em produção e o código por trás dele.

O VULK tem um servidor MCP remoto. Acrescenta um endereço ao Claude, ao Claude Code ou a outro assistente que suporte servidores MCP remotos, inicia sessão no VULK uma vez, e o assistente pode listar os teus projetos, ler os ficheiros deles, ver os teus créditos e iniciar ou continuar um build por ti. Não instalas nada nem colas nenhuma chave de API.

O endereço é:

https://app.vulk.dev/mcp

Este artigo enumera todas as ferramentas que o servidor expõe e mostra as respostas reais que provam que está a funcionar.

Prova de que está em produção

Qualquer pessoa pode verificar o servidor sem conta. Pede-lhe os metadados de início de sessão:

curl https://app.vulk.dev/.well-known/oauth-protected-resource

A 10 de outubro de 2026, respondeu:

{
  "resource": "https://app.vulk.dev/mcp",
  "authorization_servers": ["https://app.vulk.dev"],
  "scopes_supported": ["projects.read", "usage.read", "projects.write"],
  "bearer_methods_supported": ["header"],
  "resource_name": "VULK"
}

Chama o próprio servidor sem token e ele recusa com um 401 e um cabeçalho WWW-Authenticate que aponta o cliente para esses metadados. É por esse cabeçalho que um cliente MCP descobre que tem de pôr a pessoa a iniciar sessão. O mesmo servidor responde também em https://mcp.vulk.dev/mcp.

Como funciona o início de sessão

A ligação usa OAuth normal, com os passos de descoberta e registo que a especificação MCP define:

• O cliente regista-se sozinho através de um endpoint de registo, por isso nunca copias um client ID.
• O fluxo de código de autorização exige PKCE com S256, e os clientes autenticam-se sem segredo, que é o modelo certo para apps que correm no teu computador.
• O acesso é renovado com refresh tokens, mas uma ligação dura no máximo 90 dias, por mais vezes que se renove. Depois disso, voltas a aprová-la.
• O servidor fala as versões 2025-06-18, 2025-03-26 e 2024-11-05 do protocolo MCP.

Quando ligas, o VULK mostra um ecrã de consentimento que enumera exatamente o que o assistente vai poder fazer. Um assistente que só pede para ler recebe só as permissões de leitura, e o ecrã diz-te que a ligação não pode criar, alterar, publicar nem apagar nada. Há um aviso que também pomos nesse ecrã: o nome mostrado é o nome que a app deu a si própria, que o VULK não consegue verificar, por isso só aproves uma ligação que acabaste de iniciar.

Podes ver todas as apps ligadas em Definições › Integrações › Aplicações ligadas e remover qualquer uma a qualquer momento. Perde o acesso de imediato. Podes ter até 50 apps ligadas e 20 ecrãs de aprovação à espera ao mesmo tempo.

As nove ferramentas

Seis ferramentas só leem. Três podem iniciar, continuar ou parar trabalho.

Cada ferramenta declara a permissão de que precisa, e o servidor recusa uma chamada feita sem ela. A uma ligação só de leitura nem sequer são mostradas as ferramentas de build.

Como corre um build a partir de um assistente

Construir demora minutos, não milissegundos, por isso o processo está dividido em dois:

1. O assistente chama create_project com o teu briefing, até 8000 caracteres, e um request_id, um UUID novo só para esta ação.
2. O VULK verifica o teu plano e os teus créditos e responde com um recibo: o id do pedido, o id do projeto e um link para o editor. Um recibo significa que o build começou, não que terminou.
3. O assistente chama get_operation com o mesmo request_id até o trabalho estar feito, transmitindo-te qualquer pergunta que o VULK te faça.

Se uma resposta se perder, o assistente tenta de novo com o mesmo request_id e os mesmos argumentos, e o VULK trata-o como o mesmo pedido, em vez de iniciar e cobrar um segundo. Se o VULK não tiver confirmado um pedido ao fim de cerca de 20 segundos, a resposta diz unconfirmed e o assistente vai lê-lo com get_operation em vez de adivinhar.

O projeto que sai é um projeto VULK normal. Aparece na tua conta, e podes abri-lo no editor a qualquer momento.

Salvaguardas incorporadas

Há linhas traçadas de propósito, no código e não só na documentação:

• Nenhuma ferramenta publica um site. A publicação fica no editor, onde vês o que vai para produção.
• Nenhuma ferramenta compra créditos nem muda o teu plano. create_project e continue_project gastam créditos que o teu plano já inclui, exatamente como o mesmo pedido escrito no editor. Se o saldo não chegar, o VULK recusa e diz porquê.
• Nenhuma ferramenta apaga um projeto. Uma instrução enviada com continue_project pode alterar ou remover ficheiros dentro de um projeto, como o mesmo pedido escrito no editor, mas nenhuma ferramenta remove o projeto em si.

Respostas feitas para modelos

Um assistente paga cada byte que uma ferramenta devolve, por isso as respostas têm limites e dizem quando são cortadas: uma lista de projetos para nos 50, uma lista de ficheiros nas 500 entradas e um único ficheiro nos 200 000 caracteres, com uma flag truncated quando isso acontece. Cada resultado vem duas vezes, como texto para qualquer cliente e como dados estruturados para clientes no protocolo 2025-06-18, e cada ferramenta publica a forma exata desses dados como output schema, que um teste obriga a cumprir. Cada ferramenta tem também um título legível por pessoas e indicações de só leitura, destrutiva e idempotente.

As falhas voltam como resultados de ferramenta que o modelo consegue ler, como "esse ficheiro não existe, lista primeiro os ficheiros", em vez de erros de protocolo que terminam a conversa.

Configurar

Claude (web e desktop): abre Customize e depois Connectors, acrescenta um conector personalizado com o endereço acima, escolhe Connect e aprova na janela do VULK que se abre.

Claude Code:

claude mcp add --transport http vulk https://app.vulk.dev/mcp

Depois corre /mcp, escolhe vulk e inicia sessão quando o browser abrir.

Outros assistentes: acrescenta o mesmo endereço como servidor MCP HTTP remoto em qualquer cliente que suporte servidores remotos com início de sessão. O cliente abre o VULK no teu browser para aprovares. O guia passo a passo está na documentação do MCP.