MCP personnel

​

Choisir les bons identifiants

​

Créer un jeton et se connecter

1. Dans Tableau de bord → Agent, ouvrir Personal MCP.
2. Donner un nom, sélectionner les permissions nécessaires et une durée de 1 à 365 jours, 30 jours par défaut.
3. Pour models:invoke ou utilities:invoke, lier une clé API active vous appartenant. Ses limites de modèles, de budget et de RPM restent applicables. La lecture du compte ne nécessite pas de solde positif.
4. À la création, copier le jeton mcp_user_ dans les paramètres secrets du client. Ne pas l’insérer dans le code, les conversations ou les journaux. Le révoquer dans ce même tableau de bord lorsqu’il n’est plus nécessaire.

​

Découvrir les outils avant de les appeler

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_capabilities",
    "arguments": {}
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_balance",
    "arguments": {
      "input": {}
    }
  }
}

​

Permissions

​

Écritures, résultats et nouvelles tentatives

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "update_api_key",
    "arguments": {
      "input": {
        "key_id": "YOUR_KEY_ID",
        "rpmLimit": 60
      },
      "idempotencyKey": "set-key-rpm-20261106-01"
    }
  }
}

{
  "execution_id": "EXECUTION_ID",
  "replayed": false,
  "status": "completed",
  "data": {
    "balance": 100,
    "key": null
  }
}

​

Modèles et utilitaires

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "chat_completion",
    "arguments": {
      "input": {
        "body": {
          "model": "PUBLIC_MODEL_ID",
          "messages": [
            {
              "role": "user",
              "content": "Hello"
            }
          ],
          "stream": false
        }
      },
      "idempotencyKey": "chat-example-20261106-01"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "run_utility",
    "arguments": {
      "input": {
        "utility": "image-hash",
        "parameters": {},
        "files": {
          "image": [
            "YOUR_FILE_ID"
          ]
        }
      },
      "idempotencyKey": "image-hash-example-01"
    }
  }
}

​

Envoyer et récupérer des fichiers

1. Appeler begin_upload avec nom, type MIME et taille exacte en octets, au maximum 250 Mio.
2. Appeler upload_chunk avec index commençant à zéro et data Base64. Chaque bloc décodé fait au plus 1 Mio ; les index se suivent sans interruption depuis zéro.
3. Appeler finish_upload avec file_id et éventuellement SHA-256 en minuscules. Attendre status: ready.
4. Fournir l’ID à un outil compatible. get_artifact renvoie les métadonnées, ou les octets Base64 avec offset. Suivre next_offset jusqu’à null. Le lien exige une connexion au site comme propriétaire.

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "begin_upload",
    "arguments": {
      "input": {
        "name": "example.png",
        "mime_type": "image/png",
        "size": 12345
      },
      "idempotencyKey": "upload-example-begin-01"
    }
  }
}

• upload_media : au plus 20 fichiers / 250 Mio au total.
• upload_image : un fichier de 50 Mio maximum.
• edit_image : au plus 20 fichiers tous champs confondus, dont un seul mask ; 50 Mio par fichier / 100 Mio au total. Les limites de tableau par champ du schéma restent applicables.
• run_utility : les limites de nombre, de taille individuelle et totale de get_utility_schema s’appliquent, avec un plafond absolu de 250 Mio au total, même si le catalogue autorise davantage.

​

Confirmation sur le site et paiement

• Secret d’une clé : start_reveal_key_action → validation de confirmation_url par l’utilisateur → reveal_api_key avec l’id de l’action comme action_id. L’autorisation concerne cette clé et ce jeton, expire 15 minutes après création de l’action et ne sert qu’une fois. create_api_key renvoie seulement des métadonnées.
• Résiliation : cancel_subscription lance la confirmation. L’utilisateur l’exécute sur le site. Vérifier get_account_action et l’abonnement avant d’annoncer l’achèvement.
• Mot de passe/suppression : start_account_action avec password_change ou delete_account. L’utilisateur saisit codes et mots de passe sur le site, jamais auprès de l’assistant. La suppression révoque l’accès et déconnecte ; ne plus interroger MCP ensuite.
• Paiement : list_billing_products → create_checkout → paiement utilisateur → get_payment_status. Un lien ne prouve pas le paiement.
• Messages réels : resend_invoice et test_credit_alert envoient un email ou webhook, uniquement sur demande explicite.

​

Gérer les erreurs sans doublons

{
  "isError": true,
  "structuredContent": {
    "error": {
      "code": "execution_pending",
      "message": "The original execution is pending; inspect its receipt before retrying",
      "status": 409,
      "execution_id": "EXECUTION_ID"
    }
  }
}

​

Points de départ en lecture seule

• Dépenses : get_balance → summarize_usage → détails avec list_usage.
• Échec : diagnose_request avec task_id ; vérifier erreur réelle et remboursement avant un nouvel appel.
• Intégration : list_models → get_model_schema → get_api_guide, sans exécuter de modèle.
• Sécurité du compte : list_api_keys → get_api_key → list_login_records.