> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trilo.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Connect AI coding tools like Claude Code, Cursor, and Windsurf to your Trilo workspace using the Model Context Protocol (MCP)

The [Model Context Protocol (MCP)](https://modelcontextprotocol.io) is an open standard that lets AI tools interact with external services. Trilo's MCP server gives your AI coding assistant direct access to your workspace — create tasks, read pages, send messages, and more without leaving your editor.

## What You Can Do

Once connected, your AI tool can interact with your entire Trilo workspace:

| Category           | Example Prompts                                                                     |
| ------------------ | ----------------------------------------------------------------------------------- |
| **Tasks**          | "Create a bug report for the login issue" / "What tasks are assigned to me?"        |
| **Pages**          | "Write an implementation plan and save it as a page" / "Update the API docs page"   |
| **Messages**       | "Send a status update to the backend channel" / "What did the team discuss today?"  |
| **Calendar**       | "Schedule a design review for Friday at 2pm" / "What meetings do I have this week?" |
| **Meetings**       | "Summarize the standup transcript" / "Search meetings for discussion about auth"    |
| **Spreadsheets**   | "Create a sprint tracking spreadsheet" / "Update the budget numbers"                |
| **Members**        | "Who's on the mobile project?" / "Add Sarah to the backend project"                 |
| **Knowledge Base** | "Search our docs for the deployment guide" / "Find resources about onboarding"      |

## Supported AI Clients

Choose your AI tool to get started:

<CardGroup cols={2}>
  <Card title="Claude Code" icon="terminal" href="/developers/mcp/clients/claude-code">
    Anthropic's CLI tool. Supports **OAuth** and PAT authentication.
  </Card>

  <Card title="Claude Desktop" icon="desktop" href="/developers/mcp/clients/claude-desktop">
    Anthropic's desktop app. Supports **OAuth** and PAT authentication.
  </Card>

  <Card title="Cursor" icon="code" href="/developers/mcp/clients/cursor">
    AI-powered editor. Configure via Settings UI or config file.
  </Card>

  <Card title="Windsurf" icon="wind" href="/developers/mcp/clients/windsurf">
    AI-powered editor. Configure via Settings UI or config file.
  </Card>

  <Card title="Google Antigravity" icon="google" href="/developers/mcp/clients/google-antigravity">
    Google's AI coding agent. Configure via MCP Store.
  </Card>

  <Card title="Other Clients" icon="plug" href="/developers/mcp/clients/other-clients">
    Any MCP-compatible tool using HTTP transport.
  </Card>
</CardGroup>

## Authentication

Trilo supports two authentication methods for MCP connections:

| Method                          | Best For                    | Setup                                            |
| ------------------------------- | --------------------------- | ------------------------------------------------ |
| **OAuth 2.1**                   | Claude Code, Claude Desktop | Authorize in your browser — no token needed      |
| **Personal Access Token (PAT)** | All clients, CI/CD, scripts | Generate in Trilo settings, pass as Bearer token |

<Tip>
  **Use OAuth when available.** It's more secure (no token to manage) and easier to set up. Claude Code and Claude Desktop both support OAuth natively.
</Tip>

## Token Scopes

When creating a PAT, you choose which scopes to grant:

| Scope       | Permissions                                                                                                       |
| ----------- | ----------------------------------------------------------------------------------------------------------------- |
| `mcp:read`  | List and read workspaces, projects, tasks, pages, messages, members, events, meetings, resources, spreadsheets    |
| `mcp:write` | Everything in `mcp:read` plus create and update tasks, pages, messages, events, spreadsheets, and project members |
| `mcp:admin` | Everything in `mcp:write` plus administrative operations                                                          |

<Tip>
  For most development workflows, `mcp:read` and `mcp:write` together provide full access to all tools. Use `mcp:read` alone if you only want your AI tool to read data without making changes.
</Tip>

## Next Steps

<CardGroup cols={2}>
  <Card title="Tools Reference" icon="wrench" href="/developers/mcp/tools-reference">
    Browse all 40+ available MCP tools.
  </Card>
</CardGroup>