--- title: "Docs · Adea" description: "Set up Adea: connect a database, ask your first question and use Adea from Claude, ChatGPT, Grok or Cursor." url: https://adea.app/docs --- # Set up Adea in minutes Connect a read-only database, ask your first question and let Adea watch your numbers. Press / to search Popular [Connect a database](https://adea.app/docs/connect-database) [Use Adea from your AI assistant](https://adea.app/docs/ai-assistants) [The API](https://adea.app/docs/api) [Guardian and security](https://adea.app/docs/guardian) ## Four steps to your first number 1. **1 ** ### Connect a database Add a user that can only read, and Adea starts reading. About 5 [minutes](https://adea.app/docs/connect-database) 2. **2 ** ### Let Adea get to know it Adea studies your tables and writes down what it understood, so you can correct it. Adea doe[s this](https://adea.app/docs/start) 3. **3 ** ### Ask your first question Ask in plain words and get the answer with the numbers behind it. Seconds 4. **4 ** ### Watch your numbers Adea checks what is normal and tells you the day one moves. From day[one](https://adea.app/docs/watch) ## What do you want to do? ### Connect a database Create a user that can only read, allow Adea's addresses and connect. Steps for PostgreSQL, MySQL, MariaDB, Redshift, BigQuery and Snowflake. [About 5 minutes](https://adea.app/docs/connect-database) ### Connect your code Connect GitHub so Adea can tell you which change moved a number, and what shipped this week. [About 2 minutes](https://adea.app/docs/connect-code) ### Ask a question Ask in plain words and get the answer with the numbers and sources behind it. When a question needs a deeper look, Adea says what it costs before it starts. [Seconds](https://adea.app/docs/ask) ### Watch your numbers Adea checks every number it watches against what is normal for it, and tells you the day one moves and why. [From day one](https://adea.app/docs/watch) ### Lists Turn an answer or a finding into a list of the people or records behind it, with an owner and a status on every row. [A minute](https://adea.app/docs/lists) ### Slack Get findings in a Slack channel and work with them without leaving Slack. [A minute](https://adea.app/docs/slack) ### Invite your team One price covers everyone in the company. Invite colleagues, choose what each person may do, and give a person only the location they work for. [A minute](https://adea.app/docs/team) ### Use Adea from your AI assistant Connect Claude, ChatGPT, Grok or Cursor to Adea, with exactly the access you have, and ask about your business from inside the assistant. [About 3 minutes](https://adea.app/docs/ai-assistants) ## Bring Adea into your assistant Claude, ChatGPT, Grok and Cursor can ask Adea questions, with exactly the access you have and no more. ### Send this link to your AI assistant Claude, ChatGPT and other assistants can open it and set Adea up with you, one step at a time. Give your assistant this link `https://adea.app/assistant.md` Or paste this prompt `Set up Adea for me. Read https://adea.app/assistant.md and follow its steps. If I don't have an account yet, help me create one first.` Rather do it yourself? Pick your assistant and follow the steps. Your address `https://your-company.adea.app/mcp` Use your company's own address, the one you sign in to. ### Set up 1. Open Settings, then Connectors, and add a custom connector. 2. Name it Adea and paste your address. 3. Sign in to Adea when Claude asks, read what it may do, and choose Allow. In Claude Code, run ``` claude mcp add --transport http adea https://your-company.adea.app/mcp ``` [The full guide](https://adea.app/docs/ai-assistants) ## Adea only reads. It never writes. What your security team will ask, answered in short. ### A user that can only read Adea checks the user before it connects, and refuses one that can write. ### Fixed addresses Adea shows them when you connect. Allow them in your firewall, and Adea reaches your database from nowhere else. ### Guardian watches every pull It flags unusual pulls on every plan. On Business it can hold them until an administrator approves. ### Hosted in the EU Your data is never used to train AI models. [How Adea keeps data safe](https://adea.app/security) [What Guardian checks](https://adea.app/docs/guardian) ## Use Adea from your own code - [**The API ** Everything you can click in Adea is an API call. The OpenAPI file lists every one.](https://adea.app/docs/api) - [**Markdown for every page ** Add.md to any docs address, or read all the docs at once in one file.](https://adea.app/docs/connect-database.md) - [**The developer link ** Send the setup to the person who holds the database. They need no account.](https://adea.app/docs/developer-link) [All the docs as one file](https://adea.app/llms-full.txt) * ** ** * # OpenAPI $ curl https://adea.app/api/v1/openapi.json # Markdown $ curl https://adea.app/docs/connect-database.md # All the docs as one file $ curl https://adea.app/llms-full.txt ## Also in the docs - [**Start here ** What Adea does, what you need, and the four steps from signing up to your first watched number.](https://adea.app/docs/start) - [**Frequently asked questions ** Short answers to what people ask most, from “what if the answer is wrong?” to “can Adea change my data?”.](https://adea.app/docs/faq) - [**The developer link ** Send the setup to the person who holds the database or the code. They connect it without an account, and you are told when it's done.](https://adea.app/docs/developer-link) - [**Insights ** What Adea tells you when a number moves: the headline, the story of why, the causes it tested, and the list of people behind it.](https://adea.app/docs/insights) - [**Dashboards and sharing ** Pin an answer to a dashboard or to your Home, share it with colleagues, and let an administrator make a public link for people outside the company.](https://adea.app/docs/dashboards-and-sharing) - [**The API ** Every action in Adea is an API call, with the same checks as a click. The OpenAPI file lists them all.](https://adea.app/docs/api) - [**Webhooks ** Tell your own service when something happens in Adea. Each message is signed, carries ids, titles and links, and is sent again if it doesn't arrive.](https://adea.app/docs/webhooks) - [**Guardian and security ** How Adea keeps your data safe. A read-only connection, a check on every pull of data, and an administrator's approval where you want one.](https://adea.app/docs/guardian) - [**Credits and plans ** What each plan includes, how Deep credits work, and how to get more.](https://adea.app/docs/plans-and-credits) - [**Security facts ** The short list your security team asks for: where Adea runs, what it can do to your data, how it connects, who can sign in and what is logged.](https://adea.app/docs/security-facts) - [**Access and roles ** Who can see and do what in Adea, how people join, and how an administrator limits what a person sees of your data.](https://adea.app/docs/access-and-roles) ## Rather set it up together? Book 20 minutes and we connect your first source with you. Or write to hello@adea.app. [Book 20 minutes](mailto:hello@adea.app?subject=20%20minutes%20about%20Adea) [hello@adea.app](mailto:hello@adea.app)