---
title: Connect Claude (MCP)
description: Connect Claude to Sheaf's MCP server, by signing in to Sheaf or with an API key, and ask about your cases in plain language.
section: Agents
order: 2
---

Server URL: `https://sheaf.us/api/mcp`

## claude.ai, the Claude app and Cowork

1. In Claude, go to **Customize → Connectors → Add custom connector**. On a Team or Enterprise plan, an Owner adds it under **Organization settings → Connectors**.
2. Enter `https://sheaf.us/api/mcp` and click **Add**.
3. Click **Connect**, sign in to Sheaf, and click **Allow**.

Claude then acts as you, with your role, in your organization. The sign-in lasts 30 days from its last use. To end it, click **Disconnect** under **Connected agents**, in a case's [Control Center](/docs/research/the-research-page#the-control-center).

## Claude Code

```
claude mcp add --transport http sheaf https://sheaf.us/api/mcp
```

Then run `/mcp` in Claude Code, or `claude mcp login sheaf` in a terminal, and sign in the same way. Or use an [API key](/docs/api/authentication):

```
claude mcp add --transport http sheaf https://sheaf.us/api/mcp --header "Authorization: Bearer sheaf_…"
```

## Ask

For example: "Which of my cases changed today?" or "What loan amount does the Jane Doe refinance case state, and on which page?"

## The tools

| Tool | What it does |
| --- | --- |
| `list_applications` | Your cases: the ones changed last (`sort: recent`), or by name (`q`). |
| `lookup_application` | One case: its files, run, filing decisions and approved documents. |
| `search_case_text` | Searches a case's text, exactly (`pattern`) or ranked (`q`). Each hit gives its file, page and line. |
| `read_parsed_pages` | The text of pages of one file. |
| `list_intel_briefs` | A case's Intel briefs. |
| `get_intel_brief` | One brief, with its citations. |

## Good to know

- **Read-only.** No tool changes anything.
- **Your organization only.** Another organization's case is never found.
- **Too big?** An answer too big for one reply is refused, with what to ask for instead: fewer pages, a narrower search, or a `limit`.
- **Sources.** Every search hit and page carries its file and page number, so Claude can say where each figure comes from.