Conecte ferramentas de IA ao Espobase
O conector do Espobase permite que Claude, ChatGPT, Cursor, VS Code e outras ferramentas compatíveis com o Model Context Protocol (MCP) trabalhem com seus projetos: ler o esquema e a referência de API, gerar tipos, executar consultas somente leitura, conferir logs e uso e propor mudanças no banco de dados que você aprova.
Conectar
Claude (claude.ai, Claude Desktop) e ChatGPT: adicione um conector personalizado com a URL do servidor abaixo e clique em Connect. Você entra no Espobase (e-mail, GitHub, Google, Apple ou SSO), revisa o que a ferramenta pode fazer e clica em Permitir. Nenhuma chave para copiar.
https://app.espobase.com/api/mcp
No Claude: Settings › Connectors › Add custom connector. No ChatGPT: Settings › Connectors (ou Apps).
Claude Code, Cursor, VS Code e outros clientes MCP: crie um token de acesso pessoal no painel (Configurações da conta › Desenvolvedor), onde também há a configuração pronta para colar em cada ferramenta. Por exemplo, no Claude Code:
claude mcp add --transport http espobase https://app.espobase.com/api/mcp \ --header "Authorization: Bearer <your token>"
Você precisa de uma conta do Espobase; o conector funciona em todos os planos.
O que uma ferramenta conectada pode e não pode fazer
- Ela age como você: só nas organizações e nos projetos que você pode acessar, com a sua função.
- Ela vê apenas o que você permitiu na tela de consentimento (por exemplo, esquema, logs, SQL somente leitura).
- O SQL é sempre somente leitura: instruções que alterariam dados ou a estrutura são recusadas, mesmo que você seja o proprietário do projeto.
- Ela pode propor mudanças no banco de dados, mas nunca aplicá-las. Você revisa o SQL e clica em Aplicar na aba IA do seu projeto.
- Ela nunca recebe senhas de banco de dados, chaves secretas de API nem outras credenciais.
- Você pode desconectá-la a qualquer momento em Configurações da conta › Desenvolvedor › Apps conectados; o acesso termina na hora.
Ferramentas
| whoami | Sua conta do Espobase e suas organizações. |
| list_projects | Os projetos que você pode acessar, com status, ambiente, região e sua função. |
| get_project | Os detalhes de um projeto. |
| get_schema | Tabelas, colunas, relacionamentos, segurança em nível de linha e políticas (somente a estrutura). |
| get_api_reference | Endpoints REST, filtros, autenticação e uso do SDK para escrever código de cliente. |
| generate_typescript_types | espobase.types.ts para consultas tipadas com @espobase/client. |
| run_read_only_sql | Consultas SELECT, executadas com o login somente leitura do banco de dados do projeto. |
| get_logs | Logs de requisições recentes (caminhos, status, tempo; nunca corpos nem segredos). |
| get_usage | Requisições à API, largura de banda, armazenamento de banco de dados e de arquivos, uso de IA. |
| list_storage | Buckets, pastas e nomes de arquivos (não o conteúdo dos arquivos). |
| propose_schema_change | Um plano (tabelas, relacionamentos, políticas…) e o SQL dele, para você revisar e aplicar. |
| create_project | Um novo projeto, se você permitiu a criação de projetos. |
O que perguntar
- “Liste meus projetos do Espobase e resuma o esquema do banco de dados do meu projeto principal.”
- “Quais tabelas do meu projeto têm segurança em nível de linha, mas ainda não têm políticas?”
- “Escreva uma página Next.js que liste os últimos 20 pedidos do meu projeto do Espobase usando o @espobase/client.”
- “Quantas requisições à API meu projeto atendeu nesta semana, e houve erros nos logs?”
- “Proponha uma tabela todos em que cada usuário conectado veja apenas as próprias tarefas.”
Seus dados
Quando você pergunta algo à sua ferramenta de IA, o conector devolve a resposta a essa ferramenta: por exemplo, nomes de tabelas e colunas, resultados de consultas, entradas de log ou nomes de arquivos. O provedor de IA então trata esse conteúdo de acordo com os próprios termos e a própria política de privacidade. O Espobase nunca recebe sua conversa com a ferramenta de IA. Ele recebe apenas o que cada chamada de ferramenta envia: por exemplo, a consulta SQL a executar ou, no caso de propose_schema_change, seu pedido de mudança, que é guardado no histórico de IA do projeto como os pedidos digitados no painel. As chamadas de ferramentas são registradas (qual endpoint, quando, o status do resultado) para fins de segurança e auditoria.
Leia a política de privacidade do Espobase para saber como tratamos suas informações.
Solução de problemas
- Uma ferramenta diz que falta um escopo: desconecte e conecte de novo (ou crie um token com esse escopo).
- Sua organização exige login único (SSO): entre no Espobase com SSO antes de conectar.
- Um projeto não aparece na lista: talvez você tenha acesso apenas a projetos selecionados; peça a um administrador da organização.
Precisa de ajuda? Fale com o suporte.