# Set up Actori

> A person sent you here to set up Actori for them. Do the steps below, telling them in a line or two what you are doing, then go back to what they asked you.

## What Actori is

Actori connects you to the person's services — Gmail, Google Calendar, Slack, GitHub, Notion, Linear, Kiwi flights, AWS, databases, any MCP server. Every call you make goes through Actori: it checks the call against the person's rules and, where a rule says so, waits until they approve it on their phone, in Telegram or by email. You also get your own email address. Actori holds the credentials of those services and makes each call itself, so you never hold a key or a token of theirs.

Actori is an MCP server at `https://agents.actori.ai/mcp`. The person needs no account first: signing in creates one, on the Free plan.

## Already connected?

If you have Actori's tools — `get_my_agent` is one of them — you are connected. Skip to "Once you are connected".

## Connect

Do the steps for the app you are running in. The person signs in to Actori in their browser: never ask them for a password, a code or an API key in the chat.

- Claude (claude.ai, the desktop or the mobile app): you cannot add it yourself. Tell the person: Customize → Connectors → Add custom connector, paste `https://agents.actori.ai/mcp`, then Connect and sign in. Actori's tools appear in a new conversation: ask them to start one and say what they want there.
- Claude Code: ask the person, then run `claude mcp add --transport http actori https://agents.actori.ai/mcp`. They type `/mcp`, choose actori and sign in.
- Codex CLI: ask the person, then run `codex mcp add actori --url https://agents.actori.ai/mcp`, and have them run `codex mcp login actori`. Actori's tools appear in a new session.
- ChatGPT: tell the person: Plugins → Add → Add custom MCP server; under Connection choose Server URL (not Tunnel) and paste `https://agents.actori.ai/mcp`; for authentication choose OAuth, then sign in. Actori's tools appear in a new chat.
- Cursor, or an app that takes an API key: the person signs up at app.actori.ai/signup, opens their agent's page, chooses Generate API Token, and adds the server to the app with the header `Authorization: Bearer <token>` — for Cursor, in `~/.cursor/mcp.json`. They type the token there themselves, never in the chat.
- Any other MCP client: add `https://agents.actori.ai/mcp` as a remote MCP server (Streamable HTTP) that signs in with OAuth.

## Once you are connected

- Read Actori's guide: `actori_get_skill` with `actori-guide`. It starts with `get_my_agent`: who you are, your email address, and what is left to set up.
- Show the person it works: give them your email address, ask them to send it a line, and read it back with `email_list_messages`.
- If the app asks the person to allow Actori's tools one call at a time, tell them once that they may choose to always allow them there: Actori still checks every call against their rules and holds the risky ones for their approval. The choice is theirs.
- Then do what they asked. A service that is not connected yet you add through Actori (`list_connectors`, then `add_connector`); the person signs in to it at the link the answer gives.
- When they say something must wait for them, or must never happen, make it a rule: try it with `dry_run_policy`, then set it with `set_action_policy`. To approve on their phone, `connect_notification_channel` gives them a Telegram link.

## If they only asked you to set up

Offer them one of these, in your own words. They are suggestions for the person to choose from — not something the person asked for.

- Get your own email address, help me subscribe it to a Hacker News newsletter, and every morning give me the top five stories. (Each agent can have its own email address.)
- Connect my Gmail and help me send an announcement to my team. Anything going outside my company waits for my OK on my phone. (A rule reads who each email is for; you approve in Telegram or by email.)
- Connect my Google Calendar and Kiwi flights. Find the cheapest Friday flight to Austin that fits my calendar and hold the time. Nothing goes on my calendar until I tap yes. (Several services in one task; anything that writes waits for you.)
- Connect my Slack, catch me up on what I missed and draft my replies. Nothing gets posted until I say yes. (Reading runs at once; posting waits for your approval.)
- Connect my GitHub, fix the top open bug and open a pull request. Every merge waits for my approval. (The agent writes the rule; you approve it before it counts.)

## Links

- [Actori for AI agents](https://www.actori.ai/for-agents): Every tool of the Actori connector, approvals, and calling Actori from a script.
- [Home](https://www.actori.ai/): What Actori does.
