Usar Elido no Claude Desktop e Cursor

O Elido expõe um servidor MCP (Model Context Protocol) em https://api.elido.app/mcp. Uma vez conectado, Claude ou Cursor podem ler seus analytics de links, encurtar URLs e consultar detalhes de links — diretamente do chat ou editor.

O que o MCP oferece#

• Pergunte "Quantos cliques o spring-2026 teve esta semana?" — o Claude consulta o Elido e responde com o número real.
• Diga "Encurte https://example.com/very-long-path com a tag newsletter" — o Claude cria o link e mostra a URL curta.
• No Cursor, descreva um lançamento e peça para "criar um link curto para o post do blog do lançamento" — ele encurta inline.

O acesso somente leitura é o padrão. O acesso de escrita (criar, atualizar links) requer que você opte por ele durante a autorização.

Etapa 1 — Gere um token de API do Elido#

1. Vá para Dashboard → API Keys → New key.
2. Escolha os escopos:
   • links:read analytics:read para somente leitura.
   • Adicione links:write se quiser que o Claude possa criar links.
3. Copie o token (começa com ek_).

Conectar no Claude Desktop#

O Claude Desktop armazena a configuração do servidor MCP em ~/.claude.json (ou na interface de configurações em versões mais recentes).

Opção A — Interface de configurações (Claude Desktop 0.10+):

1. Abra Claude Desktop → Settings → Connectors → Add connector → Custom MCP server.
2. Cole a URL do servidor: https://api.elido.app/mcp
3. Em Authentication, escolha Bearer token e cole seu token de API do Elido.
4. Clique em Connect. O Claude busca o manifesto de ferramentas (~2 segundos) e mostra as ferramentas do Elido disponíveis.

Opção B — Editar o arquivo de configuração diretamente:

Abra ~/.claude.json em um editor de texto e adicione uma entrada em mcpServers:

{
  "mcpServers": {
    "elido": {
      "url": "https://api.elido.app/mcp",
      "headers": {
        "Authorization": "Bearer ek_your_token_here"
      }
    }
  }
}

Salve o arquivo. Reinicie o Claude Desktop. O conector do Elido aparece na lista de conectores.

Conectar no Cursor#

1. Abra Cursor → Settings → MCP (ou Cmd/Ctrl + , → pesquise "MCP").
2. Clique em Add MCP server.
3. Server URL: https://api.elido.app/mcp
4. Auth header: Authorization: Bearer ek_your_token_here
5. Clique em Save. O Cursor busca o manifesto. As ferramentas disponíveis aparecem no painel MCP.

Alternativa — Claude Code CLI (para usuários de terminal):

claude mcp add elido https://api.elido.app/mcp \
  --header "Authorization: Bearer $ELIDO_TOKEN"

Isso adiciona o servidor ao seu ~/.claude.json pela linha de comando. Configure ELIDO_TOKEN no seu perfil de shell para que esteja disponível em cada sessão.

Ferramentas disponíveis#

Ferramenta	Escopo necessário	O que faz
list_links	links:read	Lista links com filtros opcionais (tag, domínio, busca)
get_link	links:read	Retorna um único link por slug ou ID
get_analytics	analytics:read	Retorna contagem de cliques e detalhamento para um link
create_link	links:write	Cria um novo link curto
update_link	links:write	Atualiza destino, slug, tags ou data de expiração

As ferramentas são somente leitura por padrão. Criar e atualizar links requer o escopo links:write no seu token de API.

Escopo de acesso#

O servidor MCP expõe dados apenas do workspace ao qual o token de API pertence. Não é possível acessar outros workspaces. Se você tem vários workspaces, crie um token separado para cada um e adicione múltiplas entradas de servidor MCP com nomes diferentes (elido-workspace-a, elido-workspace-b).

Solução de problemas#

"Failed to fetch tool manifest" — A URL do servidor MCP está incorreta ou inacessível. Confirme abrindo https://api.elido.app/mcp em um navegador — deve retornar um manifesto JSON. Se você receber um erro de certificado, sua rede pode estar bloqueando TLS para api.elido.app.

"Unauthorized" ao chamar uma ferramenta — O token de API está ausente ou incorreto no cabeçalho Authorization. Verifique se o formato é exatamente Authorization: Bearer ek_... (sem espaços extras, prefixo correto).

Ferramentas aparecem mas ferramentas de escrita retornam "forbidden" — Seu token de API não tem links:write. Gere um novo token com esse escopo e atualize o cabeçalho na sua configuração MCP.

Claude Desktop não mostra Elido nos conectores após editar a configuração — Reinicie o Claude Desktop completamente (Quit, não apenas feche a janela). No macOS, verifique a barra de menu para uma instância do Claude em execução.

O painel MCP do Cursor mostra "disconnected" — O Cursor rebusca o manifesto a cada sessão. Se api.elido.app demorar para responder, o Cursor pode atingir o tempo limite. Tente clicar em Reconnect no painel MCP. Se o problema persistir, verifique a página de status do Elido.