# Connect an AI agent (/docs/agents)

Osorik runs a remote MCP server. Once connected, your agent can call Osorik
tools in the conversation, acting as you inside the team you choose.

| Setting | Value |
| --- | --- |
| Server URL | `https://api.osorik.dev/mcp` |
| Transport | Streamable HTTP |
| Authentication | OAuth 2.1, or a team API key as a bearer token |

## Quick start with Claude Code [#quick-start-with-claude-code]

<Steps>
<Step>

### Add the server [#add-the-server]

```bash
claude mcp add --transport http osorik https://api.osorik.dev/mcp
```

</Step>
<Step>

### Sign in [#sign-in]

```bash
claude mcp login osorik
```

Your browser opens the Osorik sign-in page. Sign in with your email code, pick
the team the agent should work in, and approve access.

</Step>
<Step>

### Ask about your team [#ask-about-your-team]

Start Claude Code and ask something like _"What address does Osorik have for my
team?"_ Claude calls the `get_team` tool and answers from your workspace.

</Step>
</Steps>

For Claude, Cursor, and other clients, see [Client setup](/docs/agents/clients).

## What agents can do [#what-agents-can-do]

Agents can read and update most of the workspace:

- **Read:** the team profile, contacts, categories, bank accounts,
  transactions, invoices and invoice settings, expenses, projects, and time
  entries, tasks and the running timer.
- **Change:** create and update contacts, add categories, categorize,
  annotate and archive transactions, draft invoices, update expenses, manage
  projects, and log time or run the timer.

Agents can't issue, void or send invoices, delete contacts or expenses,
upload documents, connect banks or manage members; do those in the app. See
[MCP tools](/docs/agents/tools) for every tool and what it needs.

## How access works [#how-access-works]

- **One team per connection.** You choose the team on the consent screen. To
  use another team, connect again and choose it.
- **Your role applies.** The agent can only do what you can do in that team.
- **Revoking access.** Sign out of the server in your client, for example with
  `claude mcp logout osorik`. An API key stops working as soon as it is revoked
  in the team settings.

See [Authentication](/docs/agents/authentication) for OAuth details and API
keys.