Connect
Create a key for the assistant in the dashboard under Settings → Integrations (the Programmatic API access section); see Authentication. Give each assistant its own key. The assistant sees only the tools the key’s scopes allow.Claude Code
Cursor
In~/.cursor/mcp.json, or .cursor/mcp.json in a project, with the key in an environment
variable:
Codex
In~/.codex/config.toml (also read by the ChatGPT desktop app), with the key in an
environment variable:
Other clients
Any MCP client that can send a fixedAuthorization header to a remote (Streamable HTTP)
server connects the same way. claude.ai, the Claude desktop and mobile apps and ChatGPT
connect through an OAuth sign-in, which this server does not offer yet. Where a Claude
organization can add a connector with a request header (a beta Anthropic offers to some
organizations), the same header works, and everyone in that organization reaches Sorraia
with that one key.
Tools
A list returns
items, total and next_cursor; the assistant passes next_cursor back as
cursor for the next page, and null means the last page. A list_submissions result:
What the assistant sees
-
Your account’s data, never more than the REST API returns for the same key. Compared with
the dashboard, these are left out:
- archived sites and widgets, and their records;
- submissions held as spam, and bookings flagged as spam;
- forms, with their submissions, that sit on a site belonging to another account (for example a form moved into an organization from a personal site);
- cart orders whose items are not all on one of your live sites (a cart that mixes sites, or holds a product with no site).
- Nothing on a site that uses HIPAA mode. An account with a HIPAA Business Associate Agreement record at Sorraia, whatever its status (signed, pending, winding down or ended), cannot use the MCP server: every tool answers with a refusal. Use the dashboard for that data.
-
What visitors typed (form answers, names, emails, notes, addresses) comes back inside an
untrustedobject, and the server tells the assistant to treat those values as data, never as instructions. Invisible characters are removed from all text. -
Long values are cut. A record that was cut carries
"truncated": true, and a page holds fewer items when its records are large.
Keys and access
- Give each assistant its own key, so you can revoke one without touching the others.
- A key created in an organization reads every site in that organization, including client sites you manage for others. A personal key reads only your personal account.
- A key you add where others share it (a Claude organization’s connector settings, a Cursor project file in a shared repository) lets everyone there reach Sorraia with it.
- Each tool call counts against the key’s API rate limit, shared with the REST API (1,000 requests an hour). Over it, the tool answers with a sentence asking to try later.
- Sorraia records every tool call that runs: the key, the tool and the ids it was given, never the data it returned. A call refused for its arguments or for the rate limit reads nothing and is not recorded or counted.
Privacy
When you connect an AI assistant, what it reads is sent to that assistant’s provider at your request, under your agreement with them.Errors
Inside a call, a refusal (a record that does not exist or that the key cannot read, the rate
limit, an account with a HIPAA agreement record) comes back as a tool error with a plain
sentence.