Referência da LinkedIn API
A LinkedIn API é a superfície completa do LinkedIn com uma única chave — Classic, Recruiter, Sales Navigator, páginas, vagas, mensagens e a Magic Route. Todas as operações abaixo estão no ar no DSN /linkedin.
Visão geral #
Esta referência cobre o LinkedIn, uma parte da Top-Rated Team API. A mesma chave também alcança a API de canais de mensagens: uma caixa de entrada compartilhada para WhatsApp, Telegram, e-mail, SMS, LINE, TikTok, Instagram, Facebook Messenger e chat web, e a sua própria conta do X. As chaves e as contas conectadas ficam no painel; adicione uma conta pelo painel.
Use com uma IA #
Todas as operações abaixo também estão disponíveis como ferramentas para qualquer assistente de IA que fale MCP, em um único endereço:
https://top-rated.team/linkedin/mcp/<your API key>Cole-o onde o seu assistente pedir o endereço de um servidor MCP. Não há nada para instalar: a chave no endereço é uma chave de API comum, as ferramentas são montadas a partir do catálogo abaixo, e toda chamada que ele faz passa pelas mesmas verificações de chave, de plano e de posse da conta que as suas próprias requisições. Revogar a chave encerra a conexão. Crie um no painel — «Conecte sua IA».
O endereço contém a sua chave, então trate-o como uma senha: qualquer pessoa que o tenha pode usar a sua conta por meio dele. Se ele vazar, revogue essa chave e crie outra.
Conectar, um cliente de cada vez
Cada cliente abaixo usa esse único endereço e nada mais. São os passos que o painel dá depois de criar uma chave, e são os mesmos para qualquer um dos agentes.
Não há etapa de login. Sua chave já está dentro desse endereço, então, quando um assistente perguntar como autenticar, escolha a opção que significa «nenhuma» — normalmente ela se chama No sign in, No authentication ou None. Não configure um cliente OAuth e não adicione um cabeçalho de requisição. É nessa única pergunta que quase todo mundo trava.
ChatGPT
Abra Settings e procure Connectors — dependendo de quando você estiver lendo isto, pode se chamar Apps & Connectors ou Plugins — e depois a opção de adicionar um conector custom (personalizado) ou servidor MCP. Em alguns planos ela fica atrás de uma chave Developer mode na mesma área. Cole o endereço como URL do servidor, escolha a opção sem autenticação e aceite o aviso que aparece sobre conectar um servidor de terceiros.
Escrito de forma vaga de propósito: a OpenAI já mudou essa configuração de lugar mais de uma vez e ela não é oferecida em todos os planos, então um caminho de cliques exato aqui estaria errado em menos de um mês. Se você não encontrar de jeito nenhum, sua conta não tem — use o Claude ou chame a API do seu próprio código. A página atual deles é help.openai.com.
Claude
- Abra Settings → Customize → Connectors.
- Clique em + Add e depois em Add custom connector.
- Dê a ele um nome que você vá reconhecer (Top-Rated Team serve), cole o endereço acima como remote MCP server URL e aperte Continue.
- Na etapa de autenticação, escolha No sign in e deixe Request headers vazio. Aperte Add.
- De volta a uma conversa, aperte + no canto inferior esquerdo, escolha Connectors e ative o conector.
Nos planos Team ou Enterprise, um proprietário o adiciona uma única vez em Organization settings → Connectors, e todos os outros o ativam na própria lista de Connectors. As instruções da própria Anthropic estão em support.claude.com, e são elas que valem se esta página e aquela algum dia discordarem.
Cursor
Abra as configurações do Cursor e procure MCP — dependendo da versão, ele já ficou em Tools, em Integrations e em Features. Adicione um servidor, dê um nome a ele e cole o endereço como o url dele; deixe os cabeçalhos e a autenticação vazios. O Cursor guarda isso em ~/.cursor/mcp.json, onde você também pode escrever a configuração por conta própria: uma entrada de mcpServers cujo único campo é url.
Um servidor colocado no .cursor/mcp.json do próprio projeto precisa ser ativado uma vez nessa mesma tela de configurações antes de o agente usá-lo. Um que esteja no arquivo da sua pasta pessoal fica ativo em todo lugar.
VS Code
O VS Code chega aos servidores MCP pelo modo agente do GitHub Copilot, então o Copilot precisa estar ligado antes. O botão abaixo entrega o endereço ao VS Code, que pergunta uma vez antes de adicioná-lo. Na mão é MCP: Add Server na paleta de comandos, depois HTTP e depois o endereço.
Esse botão abre o VS Code Stable. O Insiders aceita o mesmo endereço em vscode-insiders:, e o caminho da paleta de comandos funciona nos dois — assim como code --add-mcp num terminal.
Grok
Abra grok.com/connectors, aperte New connector e escolha Custom. Cole o endereço como a URL do servidor MCP e escolha a opção sem autenticação. Em uma conta Business ou Enterprise, primeiro um administrador adiciona o conector para a organização, e depois cada pessoa o ativa para si mesma.
Este é o assistente da xAI lendo a sua conta por meio do MCP. É diferente da API do X, que publica e lê na própria rede social X e tem chaves próprias — se é isso que você procura, conecte o canal do X.
Gemini
Abra gemini.google.com/apps — a página Connected apps dele — e escolha Add a custom app. Cole o endereço acima como MCP server URL, aperte Next e permita. Ele é adicionado no app web e depois também fica disponível no app do Gemini para celular.
Abrir os apps conectados do Gemini
O Google oferece apps personalizados em algumas contas do Google e em outras não — uma conta pessoal, em inglês e no app web em vez do celular, até o momento em que isto foi escrito — então, se não houver Add a custom app nessa página, a sua conta ainda não tem esse recurso. A página do próprio Google é support.google.com, e é nela que se deve acreditar se esta página e aquela algum dia discordarem. O Gemini pede que você confirme qualquer coisa que escreva.
Claude Code
Em um terminal, execute claude mcp add --transport http top-rated seguido do endereço acima entre aspas. Acrescente -s user para tê-lo em todos os projetos, e não só neste. Assim ele fica disponível no Claude Code onde quer que você o use — o terminal, o aplicativo de desktop e os editores em que ele se integra — e /mcp lista o que ele pode fazer. Não precisa fazer login: a chave já está no endereço.
Codex
Em um terminal, execute codex mcp add top-rated --url seguido do endereço acima entre aspas. À mão, é um bloco [mcp_servers.top-rated] com uma linha url em ~/.codex/config.toml. Não coloque uma linha command no mesmo bloco: o Codex recusa um servidor descrito das duas maneiras.
Um Codex mais antigo só lia url com experimental_use_rmcp_client = true no topo desse arquivo. Atualize o Codex primeiro e acrescente essa linha apenas se, depois disso, o endereço ainda for ignorado.
Qualquer outro
Qualquer assistente que fale MCP via HTTP aceita o mesmo endereço único e nada mais. Não há pacote para instalar nem arquivo de configuração para editar. Se ele perguntar por um transporte, é um servidor remoto via HTTP, não um comando para rodar.
Confira se funcionou. Peça ao assistente «liste as minhas contas do LinkedIn conectadas». Se ele responder com as suas contas, está tudo ligado. Se disser que não tem essa ferramenta, o endereço foi colado incompleto, sem a chave, ou o conector foi adicionado mas não ativado nessa conversa.
Catálogo de endpoints #
Todas as operações da LinkedIn API, agrupadas por área. Abra um cartão para ver os parâmetros, a requisição e a resposta.