Before you start
- An iPhone with the Spreadsheet Data Entry (SSA) app.
- Claude Code (recommended) or Claude Desktop with a custom remote MCP connector that can send a static Bearer PAT header. Not the Claude.ai connector directory — that path needs OAuth later and is out of scope here.
- A Google account that can edit the destination spreadsheet (for Sheets submits).
MCP URL:
https://sheetentry.com/mcp — Bearer PAT on every request.
Steps
- Open the SSA iOS app. On Authorization, tap Don't have an account?
- On Registration, enter email and password, then tap Sign up. (If you already have an account, tap Log in on Authorization instead.)
- On My forms, tap the gear icon (top left) → Settings.
- Tap Storage providers → under Google account, tap Log in and finish Google sign-in.
- Go back to Settings, then tap Connect AI.
-
Before creating a token, enable the Write scope (create and configure forms) —
Read and Submit are on by default; Write is off unless you check it. Tap
Create token, enter a name (for example
Claude), and confirm Create token. -
In the Token created alert, tap Copy to clipboard. Paste the
token somewhere safe for the next steps — you will not see the full
pat_…value again. - Open Claude Code (preferred) or Claude Desktop.
-
Add the SSA remote MCP connector (Streamable HTTP — no local install). Auth is a static Bearer
PAT on every request (not OAuth):
-
Claude Code (verified path):
claude mcp add --transport http ssa https://sheetentry.com/mcp --header "Authorization: Bearer pat_…"
Replace only thepat_…placeholder with your full token value (keep the singleBeareralready in the command). -
Claude Desktop: add a custom remote MCP connector to the same URL with a
static
Authorization: Bearer pat_…header. Exact menu labels vary by Desktop build — if your build has no place to set a static Bearer header, use Claude Code.
-
Claude Code (verified path):
- Confirm the connector shows as connected (reload MCP in Claude Code, or restart Claude Desktop if the client asks).
- Ask Claude to list your forms (for example: “List my forms”). Confirm it returns your SSA forms.
Done. After the PAT is connected you can ask the assistant to:
- Create or configure a Form — the Spreadsheet Data Entry app entity (name, fields, types, mapping, settings, backend binding). This is the same Form you edit under My forms in the app. When creating a Form, the assistant can also have it create a new Google Spreadsheet or a new table inside an existing Airtable base as that Form's destination — it does not create a new Airtable base.
- Get a form schema or submit a row to a Google Sheets form (Airtable submits only when that form’s Airtable account is already linked in the app).
Troubleshooting
| Symptom | What to do |
|---|---|
Error code provider_auth_required for google |
In the SSA iOS app: Settings → Storage providers → Google account → Log in. Connect AI tokens alone do not link Google. |
Error code provider_auth_required for airtable |
Open the Airtable form in the SSA iOS app and complete Airtable sign-in when prompted (Airtable is not under Storage providers). |
Error code quota_exceeded (HTTP 402, “Free send limit exceeded”)
|
Free tier allows 30 sends/month. Wait for the next month or upgrade to a paid plan in the app. |
| Token alert dismissed without copying | Create a new token in Connect AI (Create token → Copy to clipboard). Old full values are never shown again. |
| HTTP 401 / connector unauthorized |
Confirm the header value is exactly Bearer pat_… (scheme + space + full token).
Missing or truncated PAT is rejected before tools run. If the token was
revoked in Connect AI or has expired,
create a new token — fixing the header format will not help.
|
Error code rate_limit_exceeded (HTTP 429) |
Too many requests in a short time. Wait about a minute, then retry. Limits per token: 100 read / 20 submit / 20 write requests per minute. |
Tool error insufficient_scope |
Create a new Connect AI token that includes the scopes you need (agent:read,
agent:submit, and agent:write for create/configure Form).
|
| Connector cannot reach the MCP URL |
Confirm you use https://sheetentry.com/mcp.
|
Notes
- Create, copy, and revoke tokens only in the iOS Connect AI screen.
- Auth is Bearer PAT on every MCP request — not a process-wide env token and not OAuth (Claude.ai directory listing is a later task).
- Form = app object (all backends for create/configure). Submit via Claude = Google Sheets or Airtable only (not Local / OnlyOffice / Grist).
- Do not use a local Node / stdio MCP install for this path; the product path is the hosted remote endpoint.