Documentation

Démarrage rapide

Tout se passe dans la console web : créez un compte, cliquez sur « Nouveau projet » et suivez les trois étapes. Aucune clé API requise.

1. Importez votre API

   Fournissez une URL de spécification OpenAPI, une commande curl ou une collection Postman — Invokera la convertit en outils MCP typés.

2. Vérifiez la propriété du domaine

   Prouvez que le domaine de l'API vous appartient à l'aide d'un enregistrement DNS TXT ou d'un fichier well-known.

3. Publiez

   Une fois en ligne, votre projet dispose d'un point de terminaison MCP, d'un point de terminaison REST et d'une page de destination lisible par l'IA.

À quoi ressemble la réussite

Quatre moments d'un vrai projet, pour vérifier que vous êtes sur la bonne voie. Voyez le résultat en ligne : le projet de démonstration Invokera Status.

Trois façons d'importer

OpenAPI (URL)

Collez l'URL d'une spécification OpenAPI/Swagger publique dans l'onglet OpenAPI de la console — la voie la plus rapide et la plus complète.

curl

Collez une commande curl fonctionnelle dans l'onglet curl de la console — Invokera en déduit un outil typé. Par exemple :

curl https://api.example.com/v1/users -H "Authorization: Bearer KEY"

Postman

Dans Postman, exportez votre collection au format Collection v2.1 JSON, puis collez le JSON dans l'onglet Postman de la console.

Dépannage de la vérification de domaine

La vérification cherche un enregistrement TXT sur _invokera-challenge.<votre-domaine> (ou un fichier sur /.well-known/invokera-challenge.txt). Un défi reste valide 72 heures et autorise jusqu'à 30 contrôles. Échecs les plus courants :

Se connecter via MCP

Claude Code

Le moyen le plus rapide de se connecter — exécutez une commande dans votre terminal :

claude mcp add --transport http your-project https://invokera.com/r/your-project --header "Authorization: Bearer inv_YOUR_TOKEN"

Vérification : posez une question dans la conversation — si les noms de vos outils apparaissent, la connexion fonctionne.

Claude Desktop

Ajoutez votre projet à claude_desktop_config.json en utilisant le point de terminaison HTTP streamable et votre token d'endpoint :

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "your-project": {
      "type": "http",
      "url": "https://invokera.com/r/your-project",
      "headers": { "Authorization": "Bearer inv_YOUR_TOKEN" }
    }
  }
}

Après avoir modifié le fichier correspondant à votre OS, redémarrez Claude Desktop pour appliquer le changement.

Vérification : posez une question dans la conversation — si les noms de vos outils apparaissent, la connexion fonctionne.

Cursor

Créez .cursor/mcp.json à la racine de votre projet avec la même forme JSON :

{
  "mcpServers": {
    "your-project": {
      "type": "http",
      "url": "https://invokera.com/r/your-project",
      "headers": { "Authorization": "Bearer inv_YOUR_TOKEN" }
    }
  }
}

Vérification : posez une question dans la conversation — si les noms de vos outils apparaissent, la connexion fonctionne.

REST

Pas de client MCP ? Chaque projet expose aussi un point de terminaison REST auto-descriptif :

curl https://invokera.com/v1/your-project/tools -H "Authorization: Bearer inv_YOUR_TOKEN"

Automatisation / CI

Les clés API de plateforme (ik_) pour gérer vos projets par script ne sont pas encore disponibles en libre-service. Pour une intégration d'automatisation ou de CI, contactez-nous et nous en activerons une pour votre compte. Un appel ressemblera à ceci :

curl -X POST https://invokera.com/api/v1/projects -H "Authorization: Bearer ik_YOUR_API_KEY" -H "Content-Type: application/json" -d '{"specUrl":"https://api.example.com/openapi.json"}'

FAQ

Mon appel échoue avec un code d'erreur — que signifie-t-il ?

Les erreurs MCP portent un code JSON-RPC et un statut HTTP. Les plus fréquents :

La vérification du domaine échoue sans cesse — que faut-il vérifier ?

Les enregistrements DNS TXT peuvent mettre du temps à se propager — attendez quelques minutes puis réessayez. La vérification porte sur le domaine enregistrable (eTLD+1), pas sur le sous-domaine. Si votre API est hébergée sur le sous-domaine d'une plateforme, utilisez plutôt la méthode du fichier .well-known.

Quelle est la différence entre les tokens inv_ et ik_ ?

Les tokens d'endpoint inv_ permettent uniquement d'invoquer vos outils publiés. Les clés API de plateforme ik_ gèrent votre compte et vos projets — ne les confiez jamais à des agents.

Comment faire pivoter un token d'endpoint ?

Ouvrez le projet dans la console et utilisez « Faire pivoter le token ». L'ancien token cesse de fonctionner immédiatement : mettez à jour vos agents dans la foulée.

J'ai perdu mon token d'appel — comment le récupérer ?

Les tokens ne sont jamais réaffichés. Sur la page du projet, utilisez « Faire tourner le token » : vous obtenez immédiatement un nouveau token et l'ancien cesse de fonctionner — mettez à jour tous les clients qui l'utilisaient.

Claude est connecté mais ne voit aucun outil — pourquoi ?

Généralement l'une de ces trois causes : le projet n'a aucun outil activé (activez-les dans la console) ; le client n'a pas été complètement redémarré après modification de sa configuration (Claude Desktop doit être entièrement relancé) ; l'URL de l'endpoint ou le token est erroné — utilisez l'appel de test de la console pour écarter un problème côté serveur.