Ligar ao Cursor e outros

Configura o Logaco no Cursor e noutros clientes compatíveis com MCP.

Cursor

No Cursor, os servidores MCP ficam num ficheiro mcp.json:

FicheiroOnde fica disponível
~/.cursor/mcp.json (na tua pasta pessoal)Em todos os teus projectos
.cursor/mcp.json (na raiz do projecto)Só nesse projecto, e pode ser partilhado no repositório

Junta o Logaco ao ficheiro, com o endereço com conta:

~/.cursor/mcp.json
{
  "mcpServers": {
    "logaco": {
      "url": "https://api.logaco.com/v1/public/mcp/account"
    }
  }
}

Na primeira utilização, o Cursor abre o Logaco no browser: inicia sessão, escolhe as permissões e clica em Permitir. Vê ligar com conta.

Se já tiveres outros servidores no ficheiro, junta só a entrada "logaco" dentro de "mcpServers".

O Cursor só vê os servidores novos nas conversas que começam depois de os adicionares: se o Logaco não aparecer, abre uma conversa nova. Antes de usar uma ferramenta, o Cursor pede a tua aprovação.

Experimenta pedir: «Procura o logótipo do BCI no Logaco e guarda o SVG em public/logos/.»

Outros clientes MCP

O Logaco funciona em qualquer cliente que aceite servidores MCP remotos. Procura a opção para adicionar um servidor remoto (às vezes chamado conector personalizado) e usa estes dados:

Valor
Endereço com contahttps://api.logaco.com/v1/public/mcp/account
Endereço sem contahttps://api.logaco.com/v1/public/mcp
TransporteStreamable HTTP (no cliente, às vezes só «HTTP»)
Autenticação com contaOAuth 2.1, com registo automático do cliente
Autenticação com tokenCabeçalho Authorization: Bearer lgc_…

Muitos clientes usam um ficheiro JSON parecido com o do Cursor, com uma entrada "url" para o servidor. Se o cliente não souber fazer o login no browser, usa o endereço sem conta com um token.

Dados técnicos

Para quem configura clientes ou desenvolve integrações:

  • O servidor só aceita pedidos POST e responde em JSON. Não abre sessões nem envia eventos (SSE): clientes que só suportam o transporte SSE antigo não funcionam.
  • Com o endereço com conta, um pedido sem token recebe 401 com o cabeçalho WWW-Authenticate, que indica onde estão os metadados OAuth do recurso. É isso que leva o cliente a abrir o login.
  • O servidor OAuth aceita registo dinâmico de clientes (RFC 7591), exige PKCE com S256 e as permissões pedidas são read:logos, read:palettes, write:palettes e write:proposals. Os metadados estão em https://api.logaco.com/.well-known/oauth-authorization-server.
  • Um pedido pode ter no máximo 3 MB (o suficiente para uma proposta de logótipo de 2 MB em base64).

Nesta página