Aller au contenu principal
agenthouse Académie Enablement IA Overview DealDesk Digital Customer Assistant HumanProof Decision Intelligence NewsRoom Anonymizer Agentic Business Agents agenthouse OS Services Développeurs AI Credits Deutsch English Italiano Français Español 日本語

Collez ces instructions dans votre assistant IA. Il lit le guide d’installation officiel et vous accompagne pendant la connexion.

Instructions pour votre assistant
Configurez la connexion à agenthouse DealDesk.

Suivez le guide : https://agenthouse.org/fr/dealdesk/connect.md
Guide officiel du plugin : https://github.com/agenthouse-org/dealdesk-plugin/blob/main/install-for-agents.md
URL du serveur MCP : https://api.agenthouse.org/mcp/dealdesk

Utilisez la connexion avec agenthouse (OAuth). Ne commencez pas par une clé API, sauf si cet hôte ne peut pas ouvrir de navigateur.
Ne me demandez pas de coller ma clé API dans ce chat. Indiquez-moi où la saisir moi-même.
Une fois terminé, listez mes cartes DealDesk ouvertes pour confirmer la connexion.
Responsabilité des données clientsLes outils DealDesk peuvent transmettre des données clients et commerciales à l’assistant IA connecté, à ses fournisseurs de modèles et aux autres outils de la même conversation. Vous décidez quels assistants, modèles et outils vous autorisez et vous êtes responsable du traitement licite de ces données.
ChatGPT Claude Gemini GitHub Copilot Cursor, Claude Desktop, Codex Open WebUI OpenCode OpenClaw Hermes Agent Autres

ChatGPT (web et bureau)

Connexion avec agenthouse
  1. Ouvrez les paramètres de ChatGPT et accédez à la section des connecteurs (applications). Dans les espaces de travail professionnels, un administrateur doit parfois d’abord autoriser les connecteurs personnalisés (mode développeur).
  2. Créez un nouveau connecteur nommé DealDesk, collez l’URL du serveur ci-dessous et choisissez OAuth comme authentification.
  3. Connectez-vous avec agenthouse, choisissez votre projet DealDesk et autorisez l’accès.
  4. Démarrez un nouveau chat et activez DealDesk dans le menu des outils.
URL du serveur
https://api.agenthouse.org/mcp/dealdesk

Claude (claude.ai et applications Claude)

Connexion avec agenthouse
  1. Ouvrez les paramètres de Claude et accédez à Connecteurs. Avec les offres Team et Enterprise, un propriétaire ajoute les connecteurs personnalisés pour l’organisation.
  2. Ajoutez un connecteur personnalisé nommé DealDesk et collez l’URL du serveur ci-dessous.
  3. Sélectionnez Connecter, connectez-vous avec agenthouse, choisissez votre projet DealDesk et autorisez l’accès.
  4. Dans un chat, activez DealDesk depuis le menu des outils.
URL du serveur
https://api.agenthouse.org/mcp/dealdesk

Gemini CLI

Clé API de projet

Gemini CLI se connecte via le pont DealDesk local. Dans l’application web Gemini, les applications MCP personnalisées ne sont actuellement disponibles que dans Gemini Spark pour les comptes personnels éligibles. Si vous y avez accès, ajoutez-y l’URL du serveur indiquée sous « Autres ».

  1. Installez Node.js 20 ou une version ultérieure ainsi que Gemini CLI.
  2. Créez une clé API de projet et enregistrez-la sur votre ordinateur dans la variable d’environnement AGENTHOUSE_API_KEY.
  3. Ajoutez la configuration ci-dessous à ~/.gemini/settings.json (ou .gemini/settings.json dans un projet) et remplacez YOUR_PROJECT_ID.
  4. Redémarrez Gemini CLI et exécutez /mcp list. DealDesk doit apparaître comme connecté.
settings.json
{
  "mcpServers": {
    "dealdesk": {
      "command": "npx",
      "args": [
        "-y",
        "dealdesk-plugin"
      ],
      "env": {
        "AGENTHOUSE_API_URL": "https://api.agenthouse.org",
        "AGENTHOUSE_API_KEY": "$AGENTHOUSE_API_KEY",
        "AGENTHOUSE_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Créez une clé API de projet sous Gestion des accès → Clés API. La clé n’est affichée qu’une seule fois. Remplacez les espaces réservés (YOUR_PROJECT_ID et, le cas échéant, ahk_YOUR_PROJECT_API_KEY) par vos propres valeurs. Ne collez jamais la clé dans un chat. Ouvrir la gestion des accès

GitHub Copilot dans VS Code

Connexion avec agenthouse

VS Code 1.101 ou une version ultérieure prend en charge le MCP distant avec OAuth. Après l’enregistrement, choisissez Auth au-dessus de l’entrée du serveur et connectez-vous avec agenthouse.

  1. Ouvrez VS Code 1.101 ou une version ultérieure avec GitHub Copilot.
  2. Exécutez la commande « MCP: Open User Configuration » ou créez .vscode/mcp.json dans votre projet.
  3. Collez la configuration ci-dessous, enregistrez et choisissez Auth. Connectez-vous avec agenthouse, choisissez au moins un projet DealDesk et autorisez l’accès.
  4. Ouvrez Copilot Chat en mode agent et activez les outils DealDesk.
mcp.json
{
  "servers": {
    "dealdesk": {
      "type": "http",
      "url": "https://api.agenthouse.org/mcp/dealdesk"
    }
  }
}

Cursor, Claude Desktop et Codex

Connexion avec agenthouse

La connexion avec agenthouse est le chemin prévu pour ces assistants. Une clé API de projet n’est nécessaire que si aucun navigateur ne peut s’ouvrir (par exemple en CI).

  1. Cursor : installez le plugin DealDesk ou ajoutez l’URL du serveur ci-dessous comme MCP distant. Claude Desktop et Codex : installez Node.js 20 ou une version ultérieure.
  2. Claude Desktop : ouvrez claude_desktop_config.json. Codex : ouvrez sa configuration MCP. Collez la configuration MCP locale ci-dessous.
  3. Terminez la connexion avec agenthouse, choisissez au moins un projet DealDesk et autorisez l’accès. Ne créez pas de clé API pour ce chemin.
  4. Démarrez un nouveau chat et vérifiez la connexion en listant vos cartes DealDesk ouvertes.
URL du serveur
https://api.agenthouse.org/mcp/dealdesk
Configuration MCP
{
  "mcpServers": {
    "dealdesk": {
      "command": "npx",
      "args": [
        "-y",
        "dealdesk-plugin"
      ]
    }
  }
}

Open WebUI

Connexion avec agenthouse

Nécessite Open WebUI 0.6.31 ou une version ultérieure. Seuls les administrateurs peuvent ajouter des serveurs MCP. Choisissez OAuth 2.1, pas Bearer ni OAuth 2.1 (Static). N’ajoutez pas DealDesk comme outil par défaut d’un modèle. Dans Docker, définissez un WEBUI_SECRET_KEY stable, sinon la connexion est perdue après un redémarrage.

  1. Ouvrez Settings → Admin → Integrations. Sous External Tool Servers, choisissez Add Connection.
  2. Réglez Type sur MCP (Streamable HTTP). Collez l’URL du serveur ci-dessous. Auth : OAuth 2.1. Enregistrez, puis choisissez Register Client si proposé.
  3. Connectez-vous avec agenthouse, choisissez au moins un projet DealDesk et autorisez l’accès.
  4. Ouvrez un chat et activez DealDesk sous + → Integrations → Tools. Ne le définissez pas comme outil par défaut.
URL du serveur
https://api.agenthouse.org/mcp/dealdesk

OpenCode

Connexion avec agenthouse

OpenCode détecte automatiquement OAuth sur les serveurs MCP distants et enregistre le client avec DCR. Ne définissez pas oauth sur false.

  1. Ouvrez opencode.json ou opencode.jsonc dans le projet ou dans votre configuration utilisateur.
  2. Collez la configuration ci-dessous sous mcp et enregistrez.
  3. Démarrez OpenCode. Si la connexion ne démarre pas automatiquement, exécutez opencode mcp auth dealdesk. Connectez-vous avec agenthouse, choisissez au moins un projet DealDesk et autorisez l’accès.
  4. Démarrez une nouvelle conversation et vérifiez la connexion en listant vos cartes DealDesk ouvertes.
opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dealdesk": {
      "type": "remote",
      "url": "https://api.agenthouse.org/mcp/dealdesk"
    }
  }
}

OpenClaw

Connexion avec agenthouse

OpenClaw connecte le MCP distant via Streamable HTTP. Définissez auth sur oauth. La connexion enregistre les identifiants sur la Gateway.

  1. Ouvrez l’interface Control sous Settings → MCP et choisissez Add server. Vous pouvez aussi coller la configuration ci-dessous dans la configuration OpenClaw.
  2. Nom : dealdesk. Transport : Streamable HTTP. URL : l’adresse ci-dessous. Auth : oauth.
  3. Choisissez Sign in, ou exécutez openclaw mcp login dealdesk. Connectez-vous avec agenthouse, choisissez au moins un projet DealDesk et autorisez l’accès.
  4. Vérifiez la connexion avec openclaw mcp doctor dealdesk --probe et en listant vos cartes DealDesk ouvertes.
Configuration MCP
{
  "mcp": {
    "servers": {
      "dealdesk": {
        "url": "https://api.agenthouse.org/mcp/dealdesk",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

Hermes Agent

Connexion avec agenthouse

Hermes Agent (Nous Research) prend en charge le MCP distant avec OAuth 2.1 et PKCE. Les jetons sont stockés sous ~/.hermes/mcp-tokens/, pas dans le fichier de configuration.

  1. Exécutez hermes mcp add --url https://api.agenthouse.org/mcp/dealdesk --auth oauth dealdesk. Ou collez le bloc ci-dessous dans ~/.hermes/config.yaml.
  2. Si la connexion ne démarre pas automatiquement, exécutez hermes mcp login dealdesk.
  3. Connectez-vous avec agenthouse, choisissez au moins un projet DealDesk et autorisez l’accès.
  4. Redémarrez Hermes ou exécutez /reload-mcp. Vérifiez la connexion en listant vos cartes DealDesk ouvertes.
config.yaml
mcp_servers:
  dealdesk:
    url: "https://api.agenthouse.org/mcp/dealdesk"
    auth: oauth

Autres clients MCP

Connexion ou clé API
  1. Si votre client prend en charge les serveurs MCP distants avec OAuth, ajoutez l’URL du serveur et connectez-vous avec agenthouse.
  2. Sinon, lancez le pont DealDesk local avec la commande ci-dessous. Node.js 20 ou une version ultérieure est requis.
  3. Remplacez ahk_YOUR_PROJECT_API_KEY et YOUR_PROJECT_ID par vos valeurs ou définissez-les comme variables d’environnement dans votre client.
URL du serveur
https://api.agenthouse.org/mcp/dealdesk
Commande
AGENTHOUSE_API_URL=https://api.agenthouse.org AGENTHOUSE_API_KEY=ahk_YOUR_PROJECT_API_KEY AGENTHOUSE_PROJECT_ID=YOUR_PROJECT_ID npx -y dealdesk-plugin

Créez une clé API de projet sous Gestion des accès → Clés API. La clé n’est affichée qu’une seule fois. Remplacez les espaces réservés (YOUR_PROJECT_ID et, le cas échéant, ahk_YOUR_PROJECT_API_KEY) par vos propres valeurs. Ne collez jamais la clé dans un chat. Ouvrir la gestion des accès

Vérifier la connexion

Démarrez un nouveau chat et demandez à votre assistant :

Vérifier la connexion
Listez mes cartes DealDesk ouvertes.

agenthouse Confidentialité Mentions légales