Documentation développeur : API et MCP

Vue d’ensemble

API RESTProjets, prospects, réponses, mails et tâches, en JSON, avec un jeton. Serveur MCPRelie Claude à ton panel : il lit, classe et agit avec les droits que tu lui donnes.

L'API et le serveur MCP sont réservés au mode développeur : sans lui, aucun jeton ne fonctionne. Un jeton ne donne accès qu'à ton compte (et aux projets que ton équipe partage), avec les droits que tu coches, et il se supprime d'un clic.

Démarrage rapide

1. Activer le mode développeur

Dans le panel : Mon compte → Mode développeur → Activer. Les adresses de l'API et du serveur MCP s'affichent ensuite à cet endroit, ainsi que sur la page Développeur.

2. Créer un jeton

Page Développeur → Créer un jeton : donne-lui un nom et coche les droits nécessaires (read seul pour commencer). Copie-le tout de suite : il n'est affiché qu'une fois, seule son empreinte est conservée.

Terminal

export AITOOLS_TOKEN="aitk_…"

3. Premier appel

Vérifie que le jeton fonctionne avec GET /api/v1/me :

cURL

curl "https://iaboss.fr/api/v1/me" \
  -H "Authorization: Bearer $AITOOLS_TOKEN"

JavaScript

const res = await fetch("https://iaboss.fr/api/v1/me", {
  headers: { Authorization: `Bearer ${process.env.AITOOLS_TOKEN}` },
});
console.log(await res.json());

Python

import os, requests

r = requests.get(
    "https://iaboss.fr/api/v1/me",
    headers={"Authorization": f"Bearer {os.environ['AITOOLS_TOKEN']}"},
)
print(r.json())

Réponse

{
  "email": "toi@exemple.fr",
  "plan": "growth",
  "scopes": [
    "read"
  ],
  "version": "v1"
}

Tu peux maintenant explorer la référence de l'API, ou brancher Claude avec le serveur MCP.

Principes à connaître

Mêmes règles que le panel. Plafonds du plan, liste d'opposition, contrôle des adresses : l'API ne contourne rien.
Moindre droit. Trois droits distincts : read, write, jobs. Un jeton par outil, avec le minimum nécessaire.
Isolation. Une ressource d'un autre compte répond 404, exactement comme si elle n'existait pas.
Un jeton dans l'en-tête. Le jeton se place dans l'en-tête Authorization ; appelle l'API depuis un serveur ou un script, où le jeton reste privé.
Actions réelles. L'envoi de mails touche de vraies personnes : il exige une confirmation explicite.