Pular para o conteúdo
Soluções MCP

Cliente MCP · Anysphere

Como configurar MCP no Cursor

Editor de código com agente. Lê .cursor/mcp.json no projeto ou ~/.cursor/mcp.json para todos os projetos. O bloco abaixo sai no formato deste cliente, sem pedir token.

Conferido em . Formato lido em cursor.com — Model Context Protocol (MCP)

Passo 1Escolha os servidores

Quem mantém

1 selecionado: Filesystem. Ver o catálogo com os sinais de confiança

Passo 2Informe o seu sistema

Sistema
Onde instalar

Passo 3Copie a configuração para o Cursor

Nenhum token passou por este site. O que está destacado você preenche na sua máquina; o gerador não tem campo para credencial.

mcp.json.cursor/mcp.json
{
  "mcpServers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "<PASTA_PERMITIDA>"
      ]
    }
  }
}

Preencha na sua máquina

  • PASTA_PERMITIDACaminho absoluto da pasta que o assistente poderá ler e alterar (Filesystem)Ex.: /Users/voce/Documentos/projeto ou C:\Users\voce\Documentos\projeto. Só essa pasta fica acessível.Substitua <PASTA_PERMITIDA> pelo valor, direto no arquivo, na sua máquina.

Onde colar

  1. Crie a pasta .cursor na raiz do projeto (ou use a pasta .cursor da sua pasta de usuário, no modo global).
  2. Salve o bloco como mcp.json dentro dela. Se o arquivo já existir, acrescente as entradas dentro de "mcpServers".
  3. Defina as variáveis de ambiente indicadas no sistema e reabra o Cursor para que ele as enxergue.

Antes de começar

Como conferir

  • Abra as configurações do Cursor, na seção de MCP: cada servidor aparece com o estado da conexão e a lista de ferramentas.

Onde fica a configuração

ModoSistemaCaminho
Projeto (.cursor/mcp.json)macOS, Windows, Linux.cursor/mcp.json
Global (~/.cursor/mcp.json)macOS, Linux~/.cursor/mcp.json
Global (~/.cursor/mcp.json)Windows%USERPROFILE%\.cursor\mcp.json
Projeto (.cursor/mcp.json)
Vale só neste projeto e pode ser versionado com a equipe.
Global (~/.cursor/mcp.json)
Vale em todos os projetos abertos no Cursor.

Passo a passo

  1. Crie a pasta .cursor na raiz do projeto (ou use a pasta .cursor da sua pasta de usuário, no modo global).
  2. Salve o bloco como mcp.json dentro dela. Se o arquivo já existir, acrescente as entradas dentro de "mcpServers".
  3. Defina as variáveis de ambiente indicadas no sistema e reabra o Cursor para que ele as enxergue.

Como conferir

  • Abra as configurações do Cursor, na seção de MCP: cada servidor aparece com o estado da conexão e a lista de ferramentas.

Tokens e chaves neste cliente

O Cursor interpola ${env:NOME} a partir das variáveis de ambiente. O gerador usa essa forma em env e headers, então a credencial não fica escrita no arquivo.

Particularidades

  • Transportes aceitos: stdio, SSE e Streamable HTTP.
  • Servidores remotos usam "url" e, se preciso, "headers". O login por OAuth é iniciado pelo próprio Cursor.
  • Além de ${env:NOME}, existem ${workspaceFolder} e ${userHome}, úteis para caminhos.

Quando não funciona

A credencial chega vazia ao servidor
A variável de ambiente precisa existir antes de o Cursor abrir. Em macOS, aplicativos iniciados pelo Dock não herdam o que foi exportado só no terminal.
Servidor não inicia
Execute o comando e os argumentos no terminal para ver o erro; confirme que npx, uvx ou docker estão no PATH.

Outros clientes

Perguntas frequentes

Onde fica a configuração de MCP do Cursor?

Em .cursor/mcp.json.

Como informo tokens e chaves no Cursor?

O Cursor interpola ${env:NOME} a partir das variáveis de ambiente. O gerador usa essa forma em env e headers, então a credencial não fica escrita no arquivo.

Como sei que o servidor conectou no Cursor?

Abra as configurações do Cursor, na seção de MCP: cada servidor aparece com o estado da conexão e a lista de ferramentas.

De onde vem este formato?

Da documentação oficial (cursor.com — Model Context Protocol (MCP)), lida em 03/10/2026. O JSON que o gerador produz para este cliente é fixado por teste automatizado.

Continue por aqui