Connect an AI Assistant

Sporeline has a connector that AI assistants can use to work with your farm. Once it is connected, you can ask the assistant things like “what is due today” or “move these twenty blocks to fruiting” in a normal chat, and it reads and updates Sporeline for you, as you, with your role. The connector uses an open standard called MCP (Model Context Protocol), so the same address works for any assistant that supports it. Claude is the assistant we have tested end to end, and this page uses it as the worked example.

It is included on every plan, Free included.

The address

Every assistant connects to the same address:

https://api.sporeline.com/mcp

Paste it exactly, with https:// and /mcp and no slash at the end.

Connect Claude

1. In Claude, open Settings, then Connectors, and choose Add custom connector.
2. Give it the name Sporeline and paste the address above as the server URL.
3. Open Advanced settings and enter this as the OAuth Client ID: ecl8tqgb5su223370frna5oen. Leave the client secret empty. This step is needed for now because our sign-in service does not let assistants register themselves; it will go away when that changes, and this page will say so.
4. Choose Connect. A Sporeline sign-in page opens. Sign in with the same email and password you use for Sporeline. The page may still show an older address in the browser bar while we move it to a Sporeline one; it is ours.
5. The next page names the app Sporeline AI assistants and lists what it is asking for: reading your farm data, creating or updating records, and deleting records. Approve it, and you are sent back to Claude with Sporeline listed under your connectors.

If you have more than one farm, the connector works with the farm your login belongs to.

What the assistant can see and do

The assistant can only do what you can do. It signs in as you, so it gets your farm and your role, and nothing more. A Viewer’s assistant can read but not change anything, and it does not see customers. A Worker’s assistant can do the floor work a Worker does in the app. Managers and Owners get the setup and reporting tools their roles allow. A tool your role cannot use is not offered to the assistant at all.

On top of your role, you choose what to grant when you connect. Reading is always included. Creating and updating records is a separate permission, and deleting records is a third one, so you can connect an assistant that reads and updates but can never delete anything. To change what you granted, disconnect and connect again.

Customer contact and billing details are not shared with assistants unless an Owner or Manager turns on Share customer details with AI assistants under Settings → Optional features. Until then the assistant sees customer names only, and even with it on, only Managers’ and Owners’ assistants get the details.

What leaves Sporeline, and to whom

When the assistant calls a Sporeline tool, the answer goes to the company that runs the assistant, so it can write its reply to you. For Claude that is Anthropic. What they keep and for how long is set by your account with them, not by us, so it is worth reading their data settings. We send only what the tool you or the assistant asked for returns, limited by your role and the switch above. We do not send your password; the assistant gets a sign-in token that works only for this connector.

How changes are confirmed

The assistant cannot quietly change your farm. Tools that make bulk or hard-to-undo changes work in two steps. First the assistant asks for a preview (we call it a dry run), which lists exactly what would be created, changed or skipped, and shows it to you. The preview comes with a one-time confirmation code, and only a second call with that code makes the change. A code works once and expires, so an old preview can never be replayed.

Bulk and destructive changes also wait for a person to approve them inside Sporeline before they happen. The person who asked can approve their own, and an Owner can approve anyone’s. An Owner or Manager can also turn on Approve every AI change under Settings → Optional features, so that every change an assistant makes waits for approval, not just the big ones. The Approve AI Changes guide covers the approval list.

Everything an assistant changes is recorded in the activity log under your name, marked as made through an AI assistant, so you can always see who changed what.

Limits

Each person can make 60 tool calls a minute. Each farm also has a daily total: 2,000 calls on Free, 10,000 on Solo and 50,000 on Team and above. If the assistant hits a limit, it gets a message saying so and when to try again; nothing else in Sporeline is affected. A single request to the connector can be up to 64 KB, which is why an assistant importing a big spreadsheet sends it in several parts.

Disconnect or revoke

To stop an assistant using Sporeline, remove the Sporeline connector in the assistant’s own settings (in Claude, Settings, then Connectors). If you think someone else is using a connection of yours, sign out of Sporeline on the web: signing out ends every sign-in your account has, connected assistants included, within the hour, and each assistant has to be connected again. Then change your password and ask an Owner to check the activity log.

When someone leaves the farm and an Owner removes them under Settings → Team, their connected assistants stop working too, because the connector checks the person’s place on the farm every time.

Troubleshooting

The assistant says it can’t connect or can’t find a sign-in. Check the address is exactly https://api.sporeline.com/mcp. For Claude, check the OAuth Client ID from step 3 is in Advanced settings.

The sign-in page says the scope or request is invalid. The address was pasted with something extra, often a trailing slash. Remove the connector and add it again with the exact address.

A tool you expected is missing. Your role does not allow it, or you did not grant creating, updating or deleting when you connected. Disconnect and connect again to change what you granted, or ask an Owner about your role.

The assistant says a change is waiting for approval. That is the approval step working. Open Sporeline and approve it from the approvals list, or ask an Owner to.

The assistant says you have hit a limit. Wait the time it gives you, or until the next day for the daily total.

If something else goes wrong, email chase@sporeline.com with the time it happened and what you asked, and we will look at it with you.