Adicione um servidor MCP ao Cursor: onde fica o mcp.json (global ou projeto), os formatos url e command, login OAuth e o deeplink de instalação com um clique.

Em resumo: o Cursor lê servidores MCP do mcp.json, globalmente em ~/.cursor/mcp.json ou por projeto em .cursor/mcp.json. Um servidor remoto é uma entrada url; um local é um command com args. Salve o arquivo, abra Cursor Settings → Tools & MCP, entre quando o servidor mostrar Needs login, e as ferramentas ficam disponíveis para o Agent. Servidores também podem ser compartilhados como um link de instalação com um clique; o da UnifAPI está abaixo.

O suporte a MCP do Cursor é baseado em arquivo, o que é uma boa notícia: não há nada para clicar além do login OAuth, a configuração pode ser commitada e o mesmo formato JSON funciona para qualquer servidor. Este guia usa o servidor MCP da UnifAPI (https://mcp.unifapi.com, dados públicos ao vivo de X, Instagram, TikTok, YouTube, Reddit, LinkedIn, Threads e da stack de SEO) como exemplo prático.

Onde fica o mcp.json

Arquivo	Escopo	Use para
`~/.cursor/mcp.json`	Todos os projetos desta máquina, para este usuário	Servidores que você quer em todo lugar (um servidor de dados, um browser, um servidor de docs)
`.cursor/mcp.json`	Um projeto, commitado com o repositório	Servidores que pertencem ao codebase; o time os recebe ao clonar

Os dois arquivos têm o mesmo formato, e o Cursor os mescla. Se um nome aparece nos dois, a entrada do projeto vence.

Um servidor remoto: o formato url

Crie ou edite o arquivo e adicione o servidor em mcpServers:

{
  "mcpServers": {
    "unifapi": {
      "url": "https://mcp.unifapi.com"
    }
  }
}

Salve. Abra Cursor Settings → Tools & MCP (em builds mais antigas: MCP & Integrations). O servidor aparece com um ponto de status. Para um servidor protegido por OAuth como a UnifAPI, ele mostra Needs login: clique, entre ou crie uma conta UnifAPI na janela do browser e aprove o escopo somente leitura. O ponto fica verde e a lista de ferramentas se expande sob o servidor: list_operations, get_operation e call_api.

O Cursor suporta registro dinâmico de cliente do OAuth 2.0, que é o que a UnifAPI usa, então nenhum client ID é necessário. Para provedores que entregam um client ID fixo ou exigem uma URL de redirecionamento na lista de permissões, o Cursor aceita um bloco auth ao lado de url com CLIENT_ID, um CLIENT_SECRET opcional e scopes. A UnifAPI não precisa disso.

Um servidor remoto que usa um token estático em vez de OAuth recebe headers, e o valor pode vir do seu ambiente:

{
  "mcpServers": {
    "example": {
      "url": "https://mcp.example.com",
      "headers": {
        "Authorization": "Bearer ${env:EXAMPLE_TOKEN}"
      }
    }
  }
}

A UnifAPI aceita uma chave de API de workspace desse jeito, mas OAuth é o caminho recomendado: nada secreto em um arquivo, e o token é somente leitura.

Um servidor local: o formato command

Um servidor que roda na sua máquina é um comando que o Cursor inicia:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"],
      "env": {
        "NODE_OPTIONS": "--max-old-space-size=512"
      }
    }
  }
}

${workspaceFolder}, ${userHome} e ${env:NAME} são interpolados, então um .cursor/mcp.json commitado pode continuar independente da máquina. command e url são exclusivos; uma entrada com os dois é ignorada.

Links de instalação com um clique

O Cursor pode instalar um servidor a partir de um deeplink, que é como os fornecedores colocam um botão "Add to Cursor" na documentação deles. O link carrega o nome do servidor e o mesmo JSON que você escreveria à mão, codificado em base64:

cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_CONFIG

Para a UnifAPI, config é o base64 de {"url":"https://mcp.unifapi.com"}:

cursor://anysphere.cursor-deeplink/mcp/install?name=unifapi&config=eyJ1cmwiOiJodHRwczovL21jcC51bmlmYXBpLmNvbSJ9

Abrir o link em um browser entrega o servidor ao Cursor, que pede sua confirmação antes de gravá-lo no seu mcp.json global. Gere o seu com echo -n '{"url":"https://…"}' | base64 e troque os dois parâmetros. Links são práticos para onboarding; um .cursor/mcp.json commitado continua sendo a escolha certa para um time.

Usando as ferramentas

As ferramentas MCP são usadas pelo Agent (o modo de chat padrão), não pelas edições inline nem pelo Tab. Peça algo que o servidor possa responder e observe a chamada de ferramenta:

Usando o servidor MCP unifapi, liste as operações disponíveis para o TikTok e me diga qual delas retorna os vídeos recentes de um criador.

O Cursor pergunta antes de rodar uma ferramenta, a menos que você habilite a execução automática para aquele servidor nas configurações de MCP. Para um servidor somente leitura como a UnifAPI, a execução automática é razoável: a única coisa que uma chamada pode gastar são créditos de workspace, e get_operation mostra o preço por registro antes de call_api rodar.

O Cursor envia ao modelo um número limitado de ferramentas por vez (cerca de quarenta somando todos os servidores habilitados) e desabilita o resto, então prefira servidores com poucas ferramentas. O catálogo da UnifAPI fica atrás de três ferramentas de propósito; um catálogo grande exposto como uma ferramenta por endpoint ficaria quase todo desabilitado.

Uma primeira tarefa na UnifAPI

Um prompt delimitado que exercita o ciclo inteiro:

Com as ferramentas MCP unifapi: encontre as threads do Reddit dos últimos 7 dias que mencionam "Cursor MCP", puxe as 20 principais por score e resuma os problemas de configuração recorrentes com uma thread de exemplo em cada. Chame list_operations e get_operation antes de call_api.

A cobrança é por registro de dados públicos, em créditos de workspace ($0.001 cada; um crédito para a maioria dos registros, pisos maiores publicados no catálogo). Os tokens do modelo ficam no seu plano do Cursor. Um workspace novo da UnifAPI não tem créditos até a primeira recarga, que vem com um bônus único, então faça uma recarga antes do primeiro call_api.

Se você quer começar por uma tarefa em vez de por um endpoint, os agents de plataforma (Reddit, X, LinkedIn, TikTok, YouTube, Instagram, Threads) e o agent de SEO vêm, cada um, com um prompt pronto e as operações de que ele precisa.

Solução de problemas

Sintoma	O que fazer
O servidor não aparece depois de salvar o `mcp.json`	Valide o JSON (sem vírgulas sobrando); desligue e ligue o servidor em Tools & MCP, ou recarregue a janela
Needs login nunca some	Pop-ups bloqueados, ou a janela do OAuth entrou com outra conta; clique no status de novo, ou remova e adicione o servidor outra vez
Ferramentas listadas, mas acinzentadas	Você passou do limite de ferramentas ativas do Cursor; desabilite um servidor que não está usando
O Agent responde sem chamar a ferramenta	Cite o servidor no prompt uma vez ("usando o servidor MCP unifapi"); depois de uma chamada bem-sucedida ele passa a recorrer a ela sozinho
`call_api` retorna `insufficient_credits`	O workspace ainda não tem créditos; faça uma recarga no console da UnifAPI e rode de novo
Um colega não vê o servidor do projeto	O `.cursor/mcp.json` não foi commitado, ou o Cursor dele ainda não marcou o workspace como confiável

Fontes verificadas

Escrito em 14 de outubro de 2026 com base na documentação de MCP do Cursor (formatos de configuração, OAuth, interpolação) e na referência de links de instalação. Os rótulos das configurações mudam entre versões do Cursor; o formato do arquivo tem se mantido estável.

O que ler a seguir

Configuração de MCP - as instruções do conector hospedado para todos os clientes.

Como adicionar um servidor MCP ao Claude - conectores, claude_desktop_config.json e claude mcp add.

Configuração de MCP no Codex - codex mcp add e config.toml.

Contexto de agents: rules, Skills e MCP - onde o MCP se encaixa ao lado de arquivos de rules e de Skills.