---
title: "Cursor IDE"
description: "Configure o Cursor IDE para acessar as APIs da APIBrasil diretamente no seu editor com contexto completo via MCP Server."
lang: pt-BR
canonical: https://doc.apibrasil.io/mcp/ide-editores/cursor
markdown: https://doc.apibrasil.io/mcp/ide-editores/cursor.md
source: apibrasil-documentation
---

# Cursor IDE

> Configure o Cursor IDE para acessar as APIs da APIBrasil diretamente no seu editor com contexto completo via MCP Server.

- **Categoria:** IDEs e Editores
- **Dificuldade:** Fácil
- **Protocolo:** conecta ao servidor MCP
- **Atualizado em:** 14 de janeiro de 2026

## Pré-requisitos

- Cursor IDE instalado (versão 0.40+)
- Acesso ao MCP da APIBrasil

## Configuração

- **Arquivo:** `.cursor/mcp_settings.json`

```json
{
  "mcpServers": {
    "https://mcp.apibrasil.cloud/mcp": {
      "name": "APIBrasil MCP",
      "url": "https://mcp.apibrasil.cloud/mcp"
    }
  }
}
```

## Passo a passo

1. **Abrir configurações do Cursor** — No Cursor, pressione `Cmd/Ctrl + Shift + P` e procure por 'MCP: Edit Config' ou navegue até Settings > MCP Servers
2. **Adicionar servidor MCP** — Cole a configuração JSON acima no arquivo de configuração do Cursor
   ```json
   {
     "mcpServers": {
       "https://mcp.apibrasil.cloud/mcp": {
         "name": "APIBrasil MCP",
         "url": "https://mcp.apibrasil.cloud/mcp"
       }
     }
   }
   ```
3. **Validar URL do servidor** — Confirme que a URL está exatamente como no guia: https://mcp.apibrasil.cloud/mcp
4. **Reiniciar o Cursor** — Feche e reabra o Cursor para carregar a nova configuração MCP
5. **Testar a conexão** — No chat do Cursor, pergunte 'Consulte o CEP 01001000 usando a APIBrasil' e veja a IA usar o MCP automaticamente

## Solução de problemas

- **Servidor MCP não conecta** — Confirme se a URL do servidor está correta e se o endpoint está online: https://mcp.apibrasil.cloud/mcp
- **Conexão recusada ou timeout** — Verifique se o servidor MCP está online em https://mcp.apibrasil.cloud/mcp e se seus tokens estão corretos
- **Erro de configuração JSON** — Valide o JSON e remova vírgulas extras no final de objetos/arrays
- **MCP não aparece nas opções** — Atualize o Cursor para a versão mais recente (0.40+) que tem suporte completo ao MCP

## Links relacionados

- [Documentação oficial do Cursor](https://cursor.sh/docs)
- [Como obter tokens da APIBrasil](https://doc.apibrasil.io/login)
- [Integração com VS Code](https://doc.apibrasil.io/mcp/ide-editores/vscode.md)
- [Documentação MCP Protocol](https://modelcontextprotocol.io)

## Ver também

- Guia MCP: [Guia MCP](https://doc.apibrasil.io/mcp.md)
- Índice da documentação: https://doc.apibrasil.io/llms.txt
- Versão HTML desta página: https://doc.apibrasil.io/mcp/ide-editores/cursor