Usar Elido no Claude Desktop e Cursor

A Elido oferece um servidor Model Context Protocol (MCP) como programa local. Ele roda na sua máquina, chama a API REST da Elido com a sua chave de API e conversa com o cliente via stdio. Não há URL MCP hospedada nem conector OAuth: não dá para colar uma URL de servidor na tela Connectors do Claude.

Passo 1: compile o servidor

Em uma cópia do repositório da Elido, execute os comandos abaixo. Eles geram packages/mcp-server/dist/index.js; anote o caminho absoluto.

pnpm install
pnpm --filter @elido/mcp-server build

Passo 2: crie uma chave de API

1. Abra Dashboard → API Keys → New key.
2. Escolha as permissões (links:read e analytics:read para somente leitura, mais links:write para criar links).
3. Copie a chave. Ela é enviada à API como Authorization: Bearer ….

Claude Desktop

{
  "mcpServers": {
    "elido": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "ELIDO_API_KEY": "your_api_key",
        "ELIDO_WORKSPACE_ID": "42"
      }
    }
  }
}

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) e reinicie o Claude Desktop por completo.

Cursor

Adicione o mesmo bloco mcpServers em .cursor/mcp.json do projeto (ou ~/.cursor/mcp.json para todos) e reinicie o Cursor.

Claude Code

claude mcp add elido --env ELIDO_API_KEY=your_api_key -- \
  node /absolute/path/to/packages/mcp-server/dist/index.js

Rode claude mcp list para confirmar que o servidor está conectado.

Ferramentas disponíveis

Ferramenta	O que faz
create_link	Encurta uma URL com slug, domínio, título e tags opcionais
list_links	Lista os links recentes do workspace
query_analytics	Série temporal de cliques do workspace ou de um link, com fuso horário
generate_qr	QR code (SVG ou PNG) para um link existente
list_workspaces	Lista os workspaces acessíveis pela chave de API

Variáveis de ambiente: ELIDO_API_KEY (obrigatória), ELIDO_WORKSPACE_ID (opcional se a chave enxerga vários workspaces), ELIDO_API_BASE (padrão https://api.elido.app, altere para self-hosting).

Solução de problemas

O cliente mostra o servidor como falho. Verifique se o caminho em args é absoluto e se dist/index.js existe (refaça a compilação). Rode ELIDO_API_KEY=test node /absolute/path/to/packages/mcp-server/dist/index.js no terminal para ver erros de inicialização.

"Unauthorized". A chave está ausente, errada ou revogada. Crie uma nova em Dashboard → API Keys.

Criar um link retorna "forbidden". A chave não tem links:write.