Skip to content

Commit 5f24920

Browse files
BenGlutBenGlut
committed
guides: connect an AI assistant to your account (hosted MCP connector) — EN + FR
1 parent cc94431 commit 5f24920

5 files changed

Lines changed: 179 additions & 1 deletion

File tree

‎docs/guides/README.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,9 @@ Task-oriented how-to guides (shorter and more targeted than
1111
- **[When a spool's two chips read as two spools](./twin-tag-pair.md)** — the
1212
one test that settles it, why two separate write passes can never make a
1313
pair, and how to rewrite the two chips as one.
14+
- **[Connect an AI assistant to your account](./connect-an-ai-assistant.md)** —
15+
let Claude, ChatGPT or any MCP client read your spools, racks and printers,
16+
and cut it off from your account.
1417

1518
> **TODO:** more guides planned:
1619
>

‎docs/guides/connect-an-ai-assistant.md‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
# Connect an AI assistant to your account
2+
3+
Ask Claude or ChatGPT "how much PETG do I have left?" and get the answer from
4+
your own inventory. The TigerTag connector lets an AI assistant **read** your
5+
account — nothing more. It is the same idea as the local server in Tiger
6+
Studio, but hosted: it works from the web, from a phone, and without Studio
7+
running.
8+
9+
**The connector's address:**
10+
11+
```
12+
https://mcp.tigersystem.io/mcp
13+
```
14+
15+
It speaks MCP (Model Context Protocol), the open standard assistants use to
16+
reach outside tools. Any assistant that supports remote MCP servers with OAuth
17+
can use it.
18+
19+
## What the assistant can read
20+
21+
- your spools: brand, material, colours, weight left, temperatures, where each
22+
one is stored;
23+
- your racks, your wishlists and your stock history;
24+
- your printers — **including their access codes** — and your TigerScales;
25+
- what your friends share with you (their spools, racks and wishlists).
26+
27+
It **cannot change anything**: every tool is read-only. It reads as you, under
28+
the same access rules as the apps, so it can never see another account. Your
29+
account's own secrets (private key, e-mail) are never returned.
30+
31+
## Claude (web, desktop, mobile)
32+
33+
1. **Settings → Connectors → Add custom connector.**
34+
2. Name it `TigerTag`, paste the address above, leave the advanced OAuth fields
35+
empty, and add it.
36+
3. Click **Connect**. You land on tigersystem.io: sign in, check that the page
37+
says the answers go to claude.ai, and click **Allow**.
38+
4. In a conversation, switch the TigerTag connector on from the tools menu and
39+
ask your question.
40+
41+
## ChatGPT
42+
43+
Custom connectors need **developer mode** (a paid plan; on Business plans, an
44+
admin enables it).
45+
46+
1. **Settings → Apps & Connectors → Advanced settings → Developer mode** on.
47+
2. **Create** a connector: name `TigerTag`, the address above, authentication
48+
**OAuth**, no client ID or secret.
49+
3. Sign in on tigersystem.io and click **Allow**.
50+
4. In a new chat, enable the connector and ask.
51+
52+
Menu names move often in these apps; the steps stay the same.
53+
54+
## Codex, Cursor and other desktop clients
55+
56+
Add a remote MCP server of type **Streamable HTTP** with the address above and
57+
no token. The app opens your browser for the sign-in; after you click
58+
**Allow**, the browser lands on a `127.0.0.1` address — that is the app on your
59+
computer collecting the sign-in. A blank or "can't connect" page there is
60+
normal: close the tab.
61+
62+
## Cut an assistant off
63+
64+
**tigersystem.io → your account → Data → Connected assistants.** Every
65+
assistant you allowed is listed with when it was connected and last used.
66+
**Cut access** stops it at once.
67+
68+
## Good to know
69+
70+
- The assistant may answer from data up to two minutes old: recent reads are
71+
kept briefly to keep things fast and light.
72+
- Live printer state (online, printing) is not available from the cloud — only
73+
Tiger Studio, on your printer's network, sees it.
74+
- Notes, colour names and wishlist text are your words (or a friend's); the
75+
assistant is told to report them, never to take them as instructions.
76+
77+
---
78+
79+
**▲ [Documentation index](../../README.md)** · **Related:** [Tiger Studio](../products/tiger-studio.md), [Guides](./README.md)

‎i18n/fr/guides/README.md‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sourceHash: a99c0750adf8a6d7d2849cc06cdc883982f7fc088249431dde605011a952e761
2+
sourceHash: e520cc8d5e0ea7a5ba261b8c2c9261030411eef1123d7c81b9f024868cb0c127
33
sourcePath: docs/guides/README.md
44
---
55

@@ -16,6 +16,9 @@ Guides pratiques orientés tâche (plus courts et plus ciblés que les
1616
- **[Quand les deux puces d'une bobine se lisent comme deux bobines](./twin-tag-pair.md)** — le
1717
seul test qui tranche, pourquoi deux passes d'écriture séparées ne peuvent
1818
jamais faire une paire, et comment réécrire les deux puces en une seule.
19+
- **[Connecter un assistant IA à votre compte](./connect-an-ai-assistant.md)** —
20+
laisser Claude, ChatGPT ou tout client MCP lire vos bobines, racks et
21+
imprimantes, et lui couper l'accès depuis votre compte.
1922

2023
> **TODO :** d'autres guides prévus :
2124
>

‎i18n/fr/guides/connect-an-ai-assistant.md‎

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
---
2+
sourceHash: 3fe6055af094fd8e7406ff91d6def456705efa046e600819010957d5069d33a9
3+
sourcePath: docs/guides/connect-an-ai-assistant.md
4+
---
5+
6+
# Connecter un assistant IA à votre compte
7+
8+
Demandez à Claude ou à ChatGPT « combien de PETG il me reste ? » et obtenez la
9+
réponse depuis votre propre inventaire. Le connecteur TigerTag permet à un
10+
assistant IA de **lire** votre compte — rien de plus. C'est la même idée que le
11+
serveur local de Tiger Studio, mais hébergée : ça marche depuis le web, depuis
12+
un téléphone, et sans que Studio soit ouvert.
13+
14+
**L'adresse du connecteur :**
15+
16+
```
17+
https://mcp.tigersystem.io/mcp
18+
```
19+
20+
Il parle MCP (Model Context Protocol), le standard ouvert que les assistants
21+
utilisent pour accéder à des outils externes. Tout assistant qui gère les
22+
serveurs MCP distants avec OAuth peut l'utiliser.
23+
24+
## Ce que l'assistant peut lire
25+
26+
- vos bobines : marque, matière, couleurs, poids restant, températures, et où
27+
chacune est rangée ;
28+
- vos racks, vos listes d'envies et l'historique de votre stock ;
29+
- vos imprimantes — **codes d'accès compris** — et vos TigerScales ;
30+
- ce que vos amis partagent avec vous (leurs bobines, racks et listes d'envies).
31+
32+
Il **ne peut rien modifier** : chaque outil est en lecture seule. Il lit en
33+
votre nom, avec les mêmes règles d'accès que les apps, donc il ne voit jamais
34+
un autre compte. Les secrets de votre compte (clé privée, e-mail) ne sont
35+
jamais renvoyés.
36+
37+
## Claude (web, bureau, mobile)
38+
39+
1. **Réglages → Connecteurs → Ajouter un connecteur personnalisé.**
40+
2. Nommez-le `TigerTag`, collez l'adresse ci-dessus, laissez vides les champs
41+
OAuth avancés, et ajoutez-le.
42+
3. Cliquez **Connecter**. Vous arrivez sur tigersystem.io : connectez-vous,
43+
vérifiez que la page indique que les réponses partent vers claude.ai, et
44+
cliquez **Autoriser**.
45+
4. Dans une conversation, activez le connecteur TigerTag depuis le menu des
46+
outils et posez votre question.
47+
48+
## ChatGPT
49+
50+
Les connecteurs personnalisés demandent le **mode développeur** (offre payante ;
51+
sur les offres Business, c'est un administrateur qui l'active).
52+
53+
1. **Réglages → Apps et connecteurs → Paramètres avancés → Mode développeur**
54+
activé.
55+
2. **Créez** un connecteur : nom `TigerTag`, l'adresse ci-dessus,
56+
authentification **OAuth**, sans identifiant ni secret client.
57+
3. Connectez-vous sur tigersystem.io et cliquez **Autoriser**.
58+
4. Dans une nouvelle conversation, activez le connecteur et posez votre
59+
question.
60+
61+
Les noms des menus changent souvent dans ces apps ; les étapes restent les
62+
mêmes.
63+
64+
## Codex, Cursor et les autres apps de bureau
65+
66+
Ajoutez un serveur MCP distant de type **Streamable HTTP** (« diffusion HTTP »)
67+
avec l'adresse ci-dessus et sans jeton. L'app ouvre votre navigateur pour la
68+
connexion ; après **Autoriser**, le navigateur arrive sur une adresse
69+
`127.0.0.1` — c'est l'app de votre ordinateur qui récupère la connexion. Une
70+
page vide ou « impossible de se connecter » à cet endroit est normale : fermez
71+
l'onglet.
72+
73+
## Couper l'accès d'un assistant
74+
75+
**tigersystem.io → votre compte → Données → Assistants connectés.** Chaque
76+
assistant autorisé y figure, avec sa date de connexion et sa dernière
77+
utilisation. **Couper l'accès** l'arrête immédiatement.
78+
79+
## Bon à savoir
80+
81+
- L'assistant peut répondre avec des données vieilles de deux minutes au plus :
82+
les lectures récentes sont gardées brièvement pour rester rapide et léger.
83+
- L'état en direct des imprimantes (en ligne, en impression) n'est pas
84+
disponible depuis le cloud — seul Tiger Studio, sur le réseau de votre
85+
imprimante, le voit.
86+
- Les notes, noms de couleurs et textes de listes sont vos mots (ou ceux d'un
87+
ami) ; l'assistant a pour consigne de les rapporter, jamais de les suivre
88+
comme des instructions.
89+
90+
---
91+
92+
**▲ [Index de la documentation](../../README.md)** · **Voir aussi :** [Tiger Studio](../products/tiger-studio.md), [Guides](./README.md)

‎src/sidebar.mjs‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,7 @@ export const sidebar = [
8383
{ slug: 'tutorials/tigerscale-serial-port-driver', label: 'TigerScale: fixing a missing COM port', translations: { fr: 'TigerScale : faire apparaître le port COM' } },
8484
{ slug: 'guides' },
8585
{ slug: 'guides/twin-tag-pair' },
86+
{ slug: 'guides/connect-an-ai-assistant' },
8687
{ slug: 'guides/filament-materials-guide' },
8788
]),
8889

0 commit comments

Comments
 (0)