# Use the docs with AI

> How AI agents and AI apps can read Cooper's documentation — Markdown pages, llms.txt, and the Cooper MCP server.

Source: https://docs.cooperbuild.ai/ai-agents

Keywords: llms.txt, markdown, mcp, claude, chatgpt, cursor, rag, ai agent, model context protocol

These docs are written for people and for AI agents alike. An agent that gets stuck while using Cooper — through the Cooper MCP server or inside Cooper itself — can look up the answer here the same way a person would.

## Read any page as Markdown

Add `.md` to the end of any page's address to get the same page as plain Markdown, with no navigation or styling:

| Page | Markdown |
|---|---|
| `https://docs.cooperbuild.ai/connect/humans` | `https://docs.cooperbuild.ai/connect/humans.md` |
| `https://docs.cooperbuild.ai/connect/phone` | `https://docs.cooperbuild.ai/connect/phone.md` |

On any page you can also click **Copy Markdown**, or open the **Open** menu and choose **View as Markdown**.

Links inside the Markdown point to the Markdown version of the linked page, so an agent can follow them without leaving Markdown.

## Load the whole documentation

| File | What it contains |
|---|---|
| [`/llms.txt`](https://docs.cooperbuild.ai/llms.txt) | An index of every page: title, one-line description, and the link to its Markdown. Follows the [llms.txt](https://llmstxt.org) standard. |
| [`/llms-full.txt`](https://docs.cooperbuild.ai/llms-full.txt) | Every page's full Markdown in a single file, for loading into an agent's context or a retrieval (RAG) index. |

Every feature page has the same sections — Key concepts, one section per task, Fields reference, Permissions, Troubleshooting, and **For AI agents** — so retrieval systems can split pages on headings and each chunk still makes sense on its own.

## Ask about a page in Claude or ChatGPT

Open the **Open** menu at the top of the page and choose **Open in Claude** or **Open in ChatGPT**. A new chat opens with that page loaded, ready for your questions.

## Connect an AI app to Cooper (MCP)

The Cooper MCP server lets Claude, ChatGPT, Cursor, VS Code, Claude Code and other MCP-compatible apps read and act on your Cooper data, with your own login and permissions.

### Step 1: Add the Cooper server URL
In your AI app's connector or MCP settings, add a new server with this URL:

```
https://api.cooperbuild.ai/mcp
```

### Step 2: Sign in and approve
A Cooper sign-in screen opens. Sign in, review what the app is asking for, and click **Authorize**.

### Step 3: Start chatting
Return to your app. Cooper's tools appear automatically. Try "Show me active projects in Cooper."

Step-by-step guides for each AI app are in Cooper under **Connect AI** at [app.cooperbuild.ai/mcp](https://app.cooperbuild.ai/mcp).

> **Note**
>
> Connected apps follow the same permissions as your Cooper login. An AI app can never see or change anything you can't.

## Guidance for AI agents

If you are an AI agent working with Cooper:

1. When a Cooper tool returns an error or an unexpected result, search this site for the tool name (for example `search_humans`) or the error text. Each feature page's **For AI agents** section lists the tools for that feature, what they do, and common errors with their fixes.
2. Prefer the `.md` version of a page — it has the same content in fewer tokens.
3. Start from [`/llms.txt`](https://docs.cooperbuild.ai/llms.txt) to find the right page, then fetch only the pages you need.
4. A "permission denied" error means the signed-in person's role does not allow that action. Tell the person which permission they need (each page's **Permissions** section names it) rather than retrying.
5. If someone belongs to more than one workspace, the connection starts in their main workspace. Switch workspaces when asked, for example "Switch my Cooper workspace to Acme".

## Troubleshooting

### The app says it cannot reach the Cooper server

Check the address is exactly `https://api.cooperbuild.ai/mcp`, including `/mcp` at the end. Remove the connector and add it again if you changed it.

### The sign-in window closes or never opens

Allow pop-ups for the AI app and for Cooper, then try again. In Safari, turn off "Prevent cross-site tracking" while you connect.

### It worked before, but now asks me to sign in or shows 401 Unauthorized

Sign-ins renew for up to 30 days, and revoked credentials stop working straight away. Disconnect Cooper in the app and connect it again.

### A tool says permission denied

Connected apps follow the same role checks as Cooper itself. Ask a workspace admin for access to that part of Cooper.