Connect AI tools to Espobase
The Espobase connector lets Claude, ChatGPT, Cursor, VS Code and other tools that support the Model Context Protocol (MCP) work with your projects: read the schema and API reference, generate types, run read-only queries, check logs and usage, and propose database changes that you approve.
Connect
Claude (claude.ai, Claude Desktop) and ChatGPT: add a custom connector with the server URL below and click Connect. You sign in to Espobase (email, GitHub, Google, Apple or SSO), review what the tool may do, and click Allow. No keys to copy.
https://app.espobase.com/api/mcp
In Claude: Settings › Connectors › Add custom connector. In ChatGPT: Settings › Connectors (or Apps).
Claude Code, Cursor, VS Code and other MCP clients: create a personal access token in the dashboard (Account settings › Developer), which also has ready-to-paste setup for each tool. For example, in Claude Code:
claude mcp add --transport http espobase https://app.espobase.com/api/mcp \ --header "Authorization: Bearer <your token>"
You need an Espobase account; the connector works on every plan.
What a connected tool can and can't do
- It acts as you: only the organizations and projects you can reach, with your role.
- It sees only what you allowed on the consent screen (for example schema, logs, read-only SQL).
- SQL is always read-only: statements that would change data or structure are refused, even if you are the project owner.
- It can propose database changes, but never apply them. You review the SQL and click Apply in your project's AI tab.
- It never receives database passwords, API secret keys or other credentials.
- You can disconnect it at any time under Account settings › Developer › Connected apps; access ends right away.
Tools
| whoami | Your Espobase account and organizations. |
| list_projects | Projects you can reach, with status, environment, region and your role. |
| get_project | One project's details. |
| get_schema | Tables, columns, relationships, row level security and policies (structure only). |
| get_api_reference | REST endpoints, filters, authentication and SDK usage for writing client code. |
| generate_typescript_types | espobase.types.ts for typed queries with @espobase/client. |
| run_read_only_sql | SELECT queries, run as the project's read-only database login. |
| get_logs | Recent request logs (paths, status, timing; never bodies or secrets). |
| get_usage | API requests, bandwidth, database and file storage, AI usage. |
| list_storage | Buckets, folders and file names (not file contents). |
| propose_schema_change | A plan (tables, relationships, policies…) and its SQL, for you to review and apply. |
| create_project | A new project, if you allowed project creation. |
Things to ask
- “List my Espobase projects and summarize the database schema of my main project.”
- “Which tables in my project have row level security but no policies yet?”
- “Write a Next.js page that lists the latest 20 orders from my Espobase project using @espobase/client.”
- “How many API requests did my project handle this week, and were there errors in the logs?”
- “Propose a todos table where each signed-in user only sees their own todos.”
Your data
When you ask your AI tool something, the connector returns the answer to that tool: for example table and column names, query results, log entries or file names. The AI provider then handles that content under its own terms and privacy policy. Espobase never receives your conversation with the AI tool. It receives only what each tool call sends: for example the SQL query to run, or, for propose_schema_change, your change request, which is kept in the project's AI history like requests typed in the dashboard. Tool calls are logged (which endpoint, when, the result status) for security and auditing.
Read the Espobase privacy policy for how we handle your information.
Troubleshooting
- A tool says a scope is missing: disconnect and connect again (or create a token with that scope).
- Your organization requires single sign-on: sign in to Espobase with SSO before connecting.
- A project isn't listed: you may have access to selected projects only; ask an organization admin.
Need help? Contact support.