Integrações
Servidor MCP para Claude, ChatGPT e n8n
Um endpoint remoto do Model Context Protocol para que assistentes possam listar links, ler visitas e criar URLs rastreadas.
Espaços de trabalho Ultimate expõem um servidor remoto de Model Context Protocol em https://letl.ink/mcp. Claude, ChatGPT e o MCP Client do n8n falam JSON-RPC sobre Streamable HTTP. O token é o mesmo token da API REST. Espaços de trabalho no Free, Solo ou Growth recebem 403 em /mcp, mesmo que já tenham um token por outros motivos.
Protocolo e autenticação
- Versão do protocolo
2025-03-26. - Métodos:
initialize,ping,tools/list,tools/call.resources/listeprompts/listretornam listas vazias. - Autentique com
Authorization: Bearer YOUR_TOKENouX-API-KEY: YOUR_TOKEN. - Proprietários e administradores geram o token em Integrações → MCP. Gerá-lo novamente desconecta todos os clientes MCP de uma vez.
Conectar o Claude
- No Claude, abra Configurações → Conectores → Adicionar conector personalizado.
- URL:
https://letl.ink/mcp. - Cabeçalho de autenticação:
Authorization: Bearermais o seu token. - Depois de conectado, peça ao Claude para resumir o espaço de trabalho, listar links ou criar uma URL curta rastreada.
Conectar o ChatGPT
- No ChatGPT, abra Configurações → Conectores → MCP.
- Use a mesma URL e o mesmo token Bearer.
- Alguns espaços de trabalho do ChatGPT exigem o modo de desenvolvedor antes que servidores MCP personalizados apareçam. Se o conector não aparecer, verifique essa opção primeiro.
Conectar o n8n
Nó MCP Client → transporte Streamable HTTP → URL https://letl.ink/mcp → cabeçalho Authorization: Bearer YOUR_TOKEN. Os detalhes e os outros dois caminhos do n8n estão no artigo n8n.
Ferramentas
| Ferramenta | O que retorna / faz |
|---|---|
| workspace_summary | Nome do espaço de trabalho, plano, links usados/máximo, cliques neste mês-calendário, domínios, QR codes, dias de retenção, se geo e API estão ativados e se Bloquear bots está ativado |
| list_links | Links ativos (limit opcional, padrão 50, máximo 200) |
| get_link | Um link pelo id numérico ou pelo short_code |
| get_recent_visits | Cliques registrados mais recentes (limit opcional, padrão 25, máximo 100), incluindo país |
| create_link | Cria um link rastreado. type pode ser direct, utm, appstore, instagram, mobile ou device. Os tipos inteligentes seguem o plano; os campos de destino, UTM e URLs de loja são iguais aos do corpo de criação da API REST |
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-03-26",
"capabilities": {},
"clientInfo": { "name": "docs", "version": "1" }
}
}O que é informado ao modelo
No initialize, o servidor se apresenta como letlink e instrui os clientes a consultar e criar links curtos rastreados para este espaço de trabalho, incluindo campos geográficos. As ferramentas retornam JSON tanto como conteúdo de texto quanto como structuredContent, para que clientes que entendem resultados estruturados possam pular a interpretação.
Segurança
Trate um assistente conectado como um colega com acesso à API: ele pode ler linhas de visitas (incluindo o IP em alguns payloads de visita) e criar links que contam para os limites. Não cole o token Bearer em um chat. Desative o conector e troque o token se um cliente não for mais necessário.