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

# Connect Claude to Toku

> Let Claude look up and act on your Toku HR data, signed in as you.

Toku works as a connector for Claude. Once connected, you can ask Claude about your people,
onboarding, invoices, expenses, time off, payslips and documents in plain English, and have it
take the same actions you would take in Toku.

Claude signs in as you. It sees only your organization, and only the pages your Toku permissions
let you see.

## Before you start

- **Your organization must be switched on.** Toku enables this one organization at a time. Ask
  your Toku contact if you are not sure.
- **You need to be an admin** of your organization in Toku.
- **Two-factor authentication must be on** for your Toku login, or you sign in with your company's
  single sign-on. If you turned two-factor on just now, allow five minutes before connecting.

## Connect

The address of the Toku connector is:

```
https://api.toku.com/mcp
```

**Claude (web and desktop)**

1. Open **Customize → Connectors**, choose **Add**, then **Add custom connector**.
2. Name it `Toku` and paste `https://api.toku.com/mcp` as the URL. Leave the advanced
   settings empty.
3. Choose **Add**, then **Connect**. A Toku sign-in window opens.
4. Sign in with your Toku login and complete your two-factor step.
5. Back in Claude, check that Toku is listed as **Connected** under Customize → Connectors →
   Yours, then start a new chat.

On a Team or Enterprise plan, an owner of your Claude organization may need to add the
connector first; you then only choose **Connect**.

**Claude Code**

Add the connector once:

```bash
claude mcp add --transport http toku https://api.toku.com/mcp
```

Then, inside Claude Code, run `/mcp`, pick `toku` and choose **Authenticate**. Your browser
opens the Toku sign-in page; sign in and complete your two-factor step.

> **Warning:** The connector signs in as whoever is signed in to Toku in that browser. If you share a computer
> or use several Toku logins, sign out of Toku first, or use a separate browser profile.

## Check it works

Ask Claude:

> Which organization am I connected to in Toku?

It should name your organization. If Claude reaches for an "organization context" tool and is
refused, that is expected (those tools are for Toku staff): ask it to use Toku's `discover` tool to
find the current-organization operation instead. Any other refusal is covered in
[If something is refused](#if-something-is-refused).

## How Claude uses Toku

Toku offers Claude a small set of tools that find and run its operations: `discover` searches
them, `describe` explains one, `dispatch_readonly` runs a read, and `dispatch` runs anything,
including changes. The first time Claude uses each one, Claude asks for your permission. Choosing
**Always allow** for `discover`, `describe` and `dispatch_readonly` is reasonable, since they
cannot change anything. Keep `dispatch` on **Allow once**, so you see each change before it happens.

## What you can ask

| Area                | Try asking                                                               |
| ------------------- | ------------------------------------------------------------------------ |
| People              | "List everyone in my organization." "Show Maria's compensation history." |
| Onboarding          | "Who is still onboarding, and what is each person missing?"              |
| Contractor invoices | "Which contractor invoices are waiting for my review?"                   |
| Expenses            | "Show expense reports submitted this month."                             |
| Time off            | "Who is off next week?" "What is Sam's leave balance?"                   |
| Payslips            | "Find last month's payslips."                                            |
| Documents           | "List our company documents."                                            |
| Tasks               | "What admin tasks are waiting for me?"                                   |

Claude can also make changes: add a person, submit a change request, approve or reject a contractor
invoice, approve an expense report, record or approve time off, and add a document. Changes go
through `dispatch`, so as long as you keep it on **Allow once**, Claude asks you before every
change. Read what it is about to do before you approve it.

## What Claude sees

- **Your organization only.** It cannot see or act on any other organization.
- **Your permissions.** If a page is set to No Access for you in Toku, Claude cannot use it either;
  with View Only it can read but not change.
- **Less than the app shows.** Bank account numbers are masked, and download links expire after
  five minutes, so ask again for a fresh link if one stops working.

Anything you ask and anything Toku returns becomes part of your Claude conversation, under your
Claude account's data settings.

## Disconnect or switch account

- **Claude (web and desktop):** Customize → Connectors → Yours → Toku → **Disconnect**.
- **Claude Code:** run `/mcp`, pick `toku` and choose **Clear authentication**, or remove it with
  `claude mcp remove toku`.

To connect as someone else, disconnect, sign out of Toku in your browser, then connect again.

## If something is refused

| Claude says                             | What it means                                                                                                                                                             |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "This caller is not allowed to do that" | Your organization is not switched on yet, two-factor is not on for your login, or your role is not admin. Check [Before you start](#before-you-start), then contact Toku. |
| "Access to … is required"               | Your Toku permissions do not include that page. Another admin can change them under **Team & Permissions**.                                                               |
| "Full access to … is required"          | You have View Only on that page, so Claude can read it but not make that change.                                                                                          |
| "…your access is limited to your team"  | Your permissions cover your team only, and that request covers the whole organization.                                                                                    |
| "You administer several organizations…" | You are an admin of more than one organization using this. Contact Toku.                                                                                                  |
