Agents, MCP et CLI

Tout ce que fait l'inbox passe par une seule API REST. Claude Code, Cursor, Codex ou vos propres scripts s'en servent avec une clé aux droits limités, par le serveur MCP, la CLI ou le skill.

Clés d'API et droits

Un admin crée les clés dans le tableau de bord sous Réglages → Clés d'API, une par agent ou par script : vous les distinguez dans le journal d'actions et en révoquez une sans toucher aux autres. Les clés ressemblent à ig_sk_… et ne sont affichées qu'une fois. Une clé ne voit jamais que sa propre organisation.

Une clé sans droit suffisant reçoit 403 requires_reply ou 403 requires_admin (admin = droit all). Utilisez la clé comme jeton bearer :

curl https://app.inngame.app/v1/conversations?status=open \
  -H "Authorization: Bearer $INNGAME_API_KEY"

Chaque route et le droit qu'elle demande : API REST.

Serveur MCP

Le serveur MCP est sur https://app.inngame.app/mcp et parle Streamable HTTP (sans état, réponses JSON). Authentifiez-vous avec la clé d'API dans l'en-tête Authorization. Chaque outil appelle l'API REST avec cette clé : un agent ne peut jamais faire plus que sa clé ne permet, et chaque action apparaît dans le journal d'actions sous le nom de la clé. Un agent déjà branché sur https://inngame.meffysto.workers.dev/mcp continue de fonctionner.

Claude Code

claude mcp add --transport http inngame https://app.inngame.app/mcp \
  --header "Authorization: Bearer $INNGAME_API_KEY"

Cursor

Dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (un projet) :

{
  "mcpServers": {
    "inngame": {
      "url": "https://app.inngame.app/mcp",
      "headers": { "Authorization": "Bearer ig_sk_..." }
    }
  }
}

Codex

Dans ~/.codex/config.toml :

[mcp_servers.inngame]
url = "https://app.inngame.app/mcp"
http_headers = { Authorization = "Bearer ig_sk_..." }

npx inngame mcp claude|cursor|codex|json affiche ces extraits avec votre clé enregistrée déjà remplie.

Connecteurs web (OAuth)

Les connecteurs qui ne peuvent pas envoyer d'en-tête personnalisé, comme claude.ai ou ChatGPT, passent par OAuth 2.1 : ajoutez https://app.inngame.app/mcp comme connecteur personnalisé, connectez-vous à Inngame, choisissez l'organisation et l'accès (read, reply ou all). Le connecteur reçoit une clé d'API ordinaire avec ce droit, listée sous Réglages → Clés d'API, où vous pouvez la révoquer. Les documents de découverte sont sur /.well-known/oauth-protected-resource et /.well-known/oauth-authorization-server ; les clients s'enregistrent eux-mêmes (enregistrement dynamique) et utilisent PKCE.

Outils MCP

La description de chaque outil indique aussi le droit nécessaire. Les outils en lecture seule portent readOnlyHint ; ceux qui suppriment quelque chose, destructiveHint.

L'administration de la plateforme n'est jamais exposée : aucun outil, aucune clé ni aucun jeton OAuth n'y accède.

CLI

La CLI inngame (0.1.2) n'a aucune dépendance et demande Node.js 20 ou plus. Chaque commande correspond à l'API REST, avec la même clé et les mêmes droits que le MCP.

npx inngame login ig_sk_...        # saves the key to ~/.config/inngame/config.json
npx inngame whoami
npx inngame inbox --unread
npx inngame bugs --sort players
npx inngame bugs fixed bug_42 --version 1.4.3

Ajoutez --json à n'importe quelle commande pour le JSON brut ; --version affiche la version. Variables d'environnement : INNGAME_API_KEY, INNGAME_URL, INNGAME_CONFIG.

Skill

Le skill Inngame apprend à un agent de code à tenir votre support : trier l'inbox, répondre à partir de la FAQ, traiter les brouillons, trier les bugs (fusionner les doublons, les marquer corrigés dans une version, tickets GitHub et PR de correctif) et installer le SDK 0.2.3. Il passe par les outils MCP, ou par la CLI à défaut, et respecte les règles ci-dessous.

• Claude Code : placez le dossier du skill inngame dans ~/.claude/skills/inngame. En une commande :

  mkdir -p ~/.claude/skills/inngame && curl -fsSL https://inngame.app/skill/inngame/SKILL.md -o ~/.claude/skills/inngame/SKILL.md

• Codex, Cursor, T3 Code, Hermes : indiquez à l'agent le SKILL.md du skill.

Téléchargement : inngame.zip (le dossier du skill) ou SKILL.md seul. Relancez la même commande pour le mettre à jour.

Ensuite, demandez par exemple « fais le point sur le support », « de quoi se plaignent les joueurs cette semaine ? », « des nouveaux bugs ? » ou « on a sorti la 1.4.3, préviens les joueurs ».

Installation en un prompt

inngame init affiche un prompt à coller dans votre agent de code, avec la clé de l'app déjà remplie si vous passez --app :

npx inngame apps                     # find your app id
npx inngame init unity --app app_... # or: init ios, init web

L'agent ajoute le paquet (SDK 0.2.3), configure le SDK au démarrage, identifie le joueur quand il est connu (ticket Steam sur les builds Steam), ajoute une entrée Support dans votre menu pause ou réglages qui marche à la souris, au tactile et à la manette, transmet un contexte utile et vérifie que le projet compile, sans toucher au code du gameplay.

Règles d'accord humain

Elles sont imposées par le serveur, pas seulement suggérées à l'agent, pour les clés d'API, le MCP et les connecteurs OAuth.

Qui a la main. Quand un membre de l'équipe répond dans une conversation, l'IA intégrée s'y met en pause (son mode passe à off). Les réponses envoyées avec une clé d'API ne changent pas le mode de l'IA ; réglez aiMode vous-même si votre agent doit prendre la main (off) ou recevoir des brouillons (draft). inherit revient au réglage de l'app, sauf qu'une clé ne peut pas rendre une conversation à une app dont l'IA répond seule : c'est aussi une décision humaine.

L'IA intégrée et votre propre clé

Chaque app a un mode d'IA (Réglages → Apps → votre app → IA) : off (par défaut), draft (l'IA écrit, un humain envoie) ou auto (l'IA répond à partir de la FAQ et passe la main dans le doute). Chaque conversation peut le remplacer par inherit, auto, draft ou off. Vous pouvez mettre l'IA en pause pour toute une app à tout moment ; les humains continuent de répondre.

Par défaut, l'IA et la traduction tournent sur Cloudflare Workers AI et les messages de l'IA comptent dans votre formule (1 000 par mois en Indie, 10 000 en Studio). Apportez votre propre clé pour lever la limite : un admin choisit Anthropic ou OpenAI dans Réglages → Organisation et colle une clé, stockée chiffrée. C'est un réglage d'admin humain (PATCH /v1/org depuis une session connectée ; les clés d'API reçoivent 403 human_approval_required) :

PATCH /v1/org
{"aiProvider": "anthropic", "aiKey": "sk-ant-...", "aiModel": null}

Remettez aiProvider à platform pour revenir au quota inclus.