Docs

Getting started.

From nothing to an AI client running approved queries against your database — about ten minutes. Four steps: create an organization, install the connector, connect a database, connect your AI.

Create your organization

Sign in at core.gentility.ai with Google or your identity provider, and create an organization. Everything that follows — servers, databases, published queries, the audit log — belongs to it.

Install the connector

The connector is a single open-source package (github.com/gentility-ai/agent). Install it on a server that can reach the databases you want to expose. Linux (Debian/Ubuntu) and macOS are supported.

Quick install

curl -sSL https://install.gentility.ai | bash\ngentility auth

Debian / Ubuntu (apt)

sudo mkdir -p /etc/apt/keyrings
curl -s https://packages.gentility.ai/gentility-packages.gpg | sudo tee /etc/apt/keyrings/gentility-packages.asc > /dev/null
echo "deb [signed-by=/etc/apt/keyrings/gentility-packages.asc] https://packages.gentility.ai/debian/ stable main" | sudo tee /etc/apt/sources.list.d/gentility.list
sudo apt update && sudo apt install gentility-agent
gentility auth

macOS (Homebrew)

brew tap gentility-ai/agent\nbrew install gentility-agent\ngentility auth

gentility auth opens your browser to authorize the connector against your organization — no tokens to paste. Once authorized, the server appears in your console within a few seconds.

Connect a database

In the console, open Databases and paste a connection string. Gentility parses it and pre-fills the connection form. Two ways to route it:

— Direct — for databases reachable from Gentility over the network (with an IP allowlist on your side).
— Through your connector — for databases on private networks. Traffic routes through the connector you installed in step 2; the database never needs to be reachable from the internet.

Connections default to read-only. Leave them that way until you've watched the audit log and trust what your policies allow. No database handy? Use our demo (read-only, public):

postgresql://readonly:readonly_pass_123@db-demo.gentility.ai:5432/ecommerce_demo

Click Test connection, then save.

Connect your AI

Gentility speaks MCP at https://mcp.gentility.ai/. Each person connects their own client and authorizes it with OAuth — every call is attributed to them from that point on.

Claude Code

claude mcp add --scope project --transport http gentility https://mcp.gentility.ai/

Claude (web and desktop)

Settings → Connectors → add a connector named gentility with URL https://mcp.gentility.ai/, then connect and authorize. Requires Claude Pro.

ChatGPT

Settings → Connectors → add https://mcp.gentility.ai/ as an MCP connector, then connect and authorize. Requires ChatGPT Plus or Pro; OpenAI's MCP support is still marked beta on their side.

Then just ask: “Show me my databases in Gentility.”

Next: publish an interface

Direct database access is where you start, not where you finish. Publish a reviewed query to the Catalog and grant it to a colleague — their AI gets that query as a tool, and nothing else. Ask your own AI to walk you through it with the catalog_query_create tools, or see the Catalog section on the homepage for how the pieces fit.