---
title: Conectar Cursor
description: Adicione o servidor MCP do Siglata ao Cursor com um JSON curto e login OAuth. Cliente comprovado na v1.
sidebar:
  order: 1
---

Conecte o Siglata ao [Cursor](https://cursor.com) para o Agent usar os arquivos da sua organização. O Cursor é um cliente **comprovado (v1)**.

## Pré-requisitos

- Cursor instalado (desktop)
- Acesso ao e-mail que você usa no Siglata

## Passos

1. Crie o arquivo do projeto `.cursor/mcp.json`, ou o arquivo global `~/.cursor/mcp.json`.
2. Cole esta configuração (mescle em um objeto `mcpServers` existente se já houver um):

```json title=".cursor/mcp.json"
{
  "mcpServers": {
    "siglata": {
      "url": "https://www.siglata.com/v1/mcp"
    }
  }
}
```

3. Salve o arquivo.
4. Abra **Customize** (ou **Settings → MCP**) e confirme que **siglata** aparece e está ativado.
5. Quando o Cursor pedir autenticação, conclua o fluxo no navegador. Entre com o link mágico, escolha a organização e aprove os escopos.

Você também pode adicionar um servidor MCP remoto na UI do Cursor e colar a mesma URL.

## Você terminou quando…

- **siglata** aparece conectado nas configurações MCP do Cursor
- O OAuth concluiu sem erro
- No chat, o agente pode usar as ferramentas do Siglata (você deve ver `execute` e `search`)

Experimente: “Use o Siglata para listar os arquivos da minha organização.”

## Solução de problemas

- **Auth ou consentimento travado.** Cancele e inicie o OAuth de novo a partir da entrada do servidor MCP. Use o mesmo perfil do navegador ao abrir o e-mail do link mágico.
- **Organização errada.** Cada concessão vincula-se a uma organização. Remova a conexão e autorize de novo, escolhendo a organização correta.
- **Ferramentas ausentes.** Confirme que o servidor está ativado. Abra **Output → MCP Logs**. Reinicie o Cursor depois de editar o `mcp.json`.
- **Pedidos de aprovação.** O Cursor pode pedir confirmação antes de cada chamada. Aprove `execute` e `search` quando confiar na solicitação.

## O que o agente pode fazer

Listar e organizar arquivos e pastas, enviar e baixar dentro dos seus escopos e ajudar com membros e convites quando a sua função permitir. Detalhes: [MCP](/docs/agents/mcp).

Voltar para [Conectar](/docs/agents/connect).

## Para agentes

```json
{
  "mcpServers": {
    "siglata": {
      "url": "https://www.siglata.com/v1/mcp"
    }
  }
}
```

- Arquivos: projeto `.cursor/mcp.json` ou global `~/.cursor/mcp.json`
- Ferramentas: apenas `execute` e `search`
- Organização: `principal_get` dentro de `execute` (sem ferramenta `context`)
- Hub: `https://www.siglata.com/docs/agents/connect`