Connect an AI agent
Give Claude, Cursor, or another MCP client access to your Osorik team.
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
Add the server
claude mcp add --transport http osorik https://api.osorik.dev/mcpSign in
claude mcp login osorikYour browser opens the Osorik sign-in page. Sign in with your email code, pick the team the agent should work in, and approve access.
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.
For Claude, Cursor, and other clients, see Client setup.
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 for every tool and what it needs.
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 for OAuth details and API keys.