Source: https://spooly.eu/en/docs/ai

# Connect Spooly to your AI

MCP is the interface AI assistants use to call the tools of other services. With it, your AI sees spools, slots, prints, maintenance and statistics, and changes them if you allow it. It cannot control printers or delete anything for good.

> Beta: Direct connections are still in beta. I am testing them with a few accounts right now. Tell me briefly what you have in mind. Or write to support@spooly.eu.

## Address

You enter this address in your AI. The sign-in then runs through Spooly.

Address:

```
https://spooly.eu/api/mcp
```

## What you can ask

- “Which spools are running low?”
- “What is due today?”
- “How much filament did I use in October, and what did it cost?”
- “Which spool is in slot 1-2?”
- “What did my last print cost?”
- “Swapped the nozzle on the X1 Carbon, log it.”
- “Spool 1 now weighs 742 g including the spool.”
- “Put the new black PETG spool on the front shelf.”

The last three change something and only work if you allowed changes.

## Your AI

- [Claude](https://spooly.eu/en/docs/ai/claude): Custom connector in the browser or in Claude Desktop.
- [ChatGPT](https://spooly.eu/en/docs/ai/chatgpt): Custom MCP server, per OpenAI with Business, Enterprise and Edu.
- [Claude Code](https://spooly.eu/en/docs/ai/claude-code): One command in the terminal.
- [Other AIs](https://spooly.eu/en/docs/ai/other): With its own sign-in or with a key.

## If something does not work

| Message | What to do |
| --- | --- |
| Direct connections are still in beta. | Your account is not part of it yet. Ask for access. |
| This works with Spooly Pro. | You need Pro or the trial. |
| This app cannot sign in directly yet. | Create a key under Settings, Devices & keys and enter it in the app. |
| This request has expired. | Start the connection again in your AI. |
| The sign-in in Claude or ChatGPT was interrupted | Connect Spooly in your AI again. If an old or half-finished connection is then in the list, revoke it in Spooly under Settings, Devices & keys. |
| `insufficient_scope` | The connection lacks the permission to change. Connect again and leave “Also allow changes” on. |
| `fair_use` | Today’s 10,000 calls are used up. It continues after midnight (UTC). |
| `too_many_parallel` | Too many requests at once. Wait a moment, then try again. |