O Yuli como servidor MCP

Como o yuli-mcp expõe o IDE inteiro ao seu agente de terminal, como ele se conecta e o que acontece se o Yuli estiver fechado.

O Yuli inclui o yuli-mcp, um servidor do Model Context Protocol (MCP). Com ele, o Claude Code, o Kiro, o Codex e o Antigravity usam o IDE completo como ferramentas: compilar, testar, verificar, navegar pelo código, consultar o banco de dados, operar o Web Studio e acompanhar a missão.

No Modo assinatura você não precisa configurar nada: o Yuli registra o yuli-mcp em cada agente ao iniciá-lo. Esta página explica como ele funciona por dentro.

Como ele se conecta

Seu agente  ──stdio / JSON-RPC 2.0──▶  yuli-mcp  ──TCP 127.0.0.1 + token──▶  Yuli (motor)

Peça	Detalhe
Transporte com o agente	MCP via `stdio`, JSON-RPC 2.0, uma mensagem JSON por linha.
Versões do protocolo	`2025-06-18`, `2025-03-26` e `2024-11-05`.
Capacidades	Ferramentas. Recursos e prompts são respondidos vazios.
Conexão com o IDE	Socket TCP apenas em loopback (`127.0.0.1`), em uma porta aleatória.
Autenticação	Um token de sessão próprio do Yuli em cada requisição. Não é uma credencial da Anthropic nem de nenhum provedor.
Tarefas longas	Envia notificações de progresso. Uma chamada pode durar até 40 minutos.

O arquivo de conexão

Ao iniciar, o motor grava o endpoint.json com a porta, o token e o processo dele. No Linux e no macOS, só o seu usuário pode ler o arquivo.

Sistema	Caminho
Windows	`%APPDATA%\.yulicode\claude-bridge\endpoint.json`
macOS	`~/Library/Application Support/.yulicode/claude-bridge/endpoint.json`

Quando o Yuli abre o terminal de um agente, ele também passa a porta e o token por variáveis de ambiente, junto com a raiz do projeto.

Um binário estável

Os agentes iniciam uma cópia estável do yuli-mcp na pasta local do Yuli (no Windows, %LOCALAPPDATA%\.yulicode\bin\yuli-mcp.exe). Ela sobrevive às atualizações do Yuli, então a configuração do agente não quebra ao atualizar.

Se o Yuli estiver fechado

As ferramentas yuli_* funcionam enquanto o Yuli estiver aberto com esse projeto. Se não estiver:

A lista de ferramentas oferece só o yuli_status, que explica o motivo.
Uma chamada responde: “Yuli Code is not open (or this project isn't open in it). Open the project in Yuli and try again; the Yuli tools work while Yuli is running.”
Os hooks saem sem bloquear nada: o seu agente continua funcionando.
A linha de status do Claude Code mostra ◆ Yuli · desconectado.

Se o /mcp no Claude Code mostrar yuli com erro, abra o projeto no Yuli. As ferramentas reaparecem sozinhas.

Subcomandos

Comando	Para quê
`yuli-mcp mcp --project <raíz>`	O servidor MCP. É o modo padrão.
`yuli-mcp hook <Evento> --project <raíz>`	Encaminha um hook do agente ao Yuli.
`yuli-mcp gate --project <raíz> --stage <etapa>`	Executa o gate de qualidade. Retorna 0, 1 ou 2.
`yuli-mcp --version`	Mostra a versão.

A opção --agent kiro|codex|antigravity identifica qual agente está chamando. Assim, cada agente tem sua própria conversa, missão e janela de alterações.

Quantas ferramentas o seu agente recebe

Ele recebe tudo o que o Modo Platform pode usar nesse projeto: um núcleo de ferramentas com nome próprio e o restante do motor. O total depende do projeto: as ferramentas de uma capacidade que não está ativa ficam ocultas (por exemplo, as de banco de dados se não houver conexões, ou as do Sonar se ele não estiver vinculado).

O número exato aparece na barra do agente: Conectado ao Yuli · N ferramentas.

Ficam de fora apenas seis ferramentas internas do ciclo próprio do Yuli: propor alterações, iniciar subagentes, buscar ferramentas, perguntar, publicar o plano e atualizá-lo. O seu agente tem as dele, e o plano dele se reflete no Yuli com yuli_progress.

Veja o catálogo em Ferramentas do Yuli.

As mesmas proteções

Cada chamada passa pelas mesmas regras do agente próprio:

Autorização e cartões de aprovação no Yuli.
Hooks do projeto.
Git, CI e DevOps só se você pediu.
Segredos protegidos.
“Pare” significa pare.

Os resultados aparecem nos painéis do Yuli (Execução, Testes, Problemas) e contam como verificação.

Conectores externos

Se você configurou servidores MCP no Yuli (Ferramentas → Servidores MCP…: GitHub, GitLab, Jenkins, CloudBees, Jira, SonarQube…), o seu agente também os recebe por meio do yuli-mcp, como yuli_mcp_<servicio>_<herramienta>. As ferramentas de leitura rodam livremente; as que escrevem pedem aprovação e nunca rodam no modo autônomo.