Agents de code et éditeurs

Connectez Claude Code, Codex, Cursor, VS Code, OpenCode et Windsurf au serveur MCP de TwexAPI par connexion ou avec une clé API.

Tous les clients ci-dessous se connectent au même serveur, https://api.twexapi.io/mcp, en Streamable HTTP. La plupart peuvent se connecter avec votre compte TwexAPI : vous ajoutez seulement l’URL et le client ouvre un navigateur pour que vous approuviez l’accès. Utilisez une clé API si le client ne prend pas en charge la connexion MCP ou si vous préférez une clé.

« Testé » signifie que nous avons exécuté le flux complet, de la connexion à un appel d’outil, avec ce client. Les autres méthodes de connexion reposent sur la prise en charge de l’autorisation MCP documentée par chaque éditeur. Si la connexion échoue, utilisez une clé API. Pour Claude.ai, Claude Desktop et ChatGPT, consultez la présentation du serveur MCP et ChatGPT.

Claude Code

Ajoutez le serveur :

claude mcp add --transport http twexapi https://api.twexapi.io/mcp

Exécutez ensuite /mcp dans une session Claude Code, choisissez twexapi et sélectionnez Authenticate pour approuver l’accès dans le navigateur. Ajoutez --scope project pour partager le serveur avec votre équipe via .mcp.json ; chaque personne se connecte avec son propre compte.

Pour utiliser une clé API, placez l’en-tête dans .mcp.json. Claude Code développe ${TWEXAPI_API_KEY} à partir de votre environnement :

{
  "mcpServers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${TWEXAPI_API_KEY}"
      }
    }
  }
}

Cursor

Ajoutez-le à ~/.cursor/mcp.json (tous les projets) ou à .cursor/mcp.json (un projet) :

{
  "mcpServers": {
    "twexapi": {
      "url": "https://api.twexapi.io/mcp"
    }
  }
}

Ouvrez Settings → MCP. Le serveur affiche Needs authentication. Sélectionnez Authenticate, approuvez l’accès dans le navigateur, puis autorisez le navigateur à ouvrir Cursor. Le serveur est prêt lorsqu’il affiche trois outils activés.

Pour utiliser une clé API :

{
  "mcpServers": {
    "twexapi": {
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${env:TWEXAPI_API_KEY}"
      }
    }
  }
}

Codex

Ajoutez le serveur et connectez-vous :

codex mcp add twexapi --url https://api.twexapi.io/mcp
codex mcp login twexapi
codex mcp list

La CLI, l’application et l’extension IDE de Codex partagent la même configuration dans ~/.codex/config.toml :

[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"

Pour utiliser une clé API, indiquez la variable d’environnement qui la contient. Codex l’envoie en tant que Authorization: Bearer :

[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"
bearer_token_env_var = "TWEXAPI_API_KEY"

VS Code

Exécutez MCP: Add Server depuis la palette de commandes et choisissez HTTP, ou ajoutez-le à .vscode/mcp.json :

{
  "servers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp"
    }
  }
}

Démarrez le serveur et approuvez la demande de connexion qui s’affiche dans le navigateur.

Pour utiliser une clé API, laissez VS Code vous la demander une fois et la stocker de manière sécurisée :

{
  "inputs": [
    {
      "type": "promptString",
      "id": "twexapi-key",
      "description": "TwexAPI API key",
      "password": true
    }
  ],
  "servers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${input:twexapi-key}"
      }
    }
  }
}

OpenCode

Ajoutez-le à opencode.json :

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "twexapi": {
      "type": "remote",
      "url": "https://api.twexapi.io/mcp"
    }
  }
}

OpenCode détecte que le serveur exige une connexion et ouvre le navigateur. Si ce n’est pas le cas, exécutez opencode mcp auth twexapi. Vérifiez l’état avec opencode mcp list et utilisez opencode mcp debug twexapi si la connexion échoue.

Pour utiliser une clé API, désactivez la connexion automatique :

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "twexapi": {
      "type": "remote",
      "url": "https://api.twexapi.io/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:TWEXAPI_API_KEY}"
      }
    }
  }
}

Windsurf

Nous n’avons pas encore confirmé la connexion dans Windsurf : utilisez donc une clé API. Ajoutez-la à ~/.codeium/windsurf/mcp_config.json (ouvrez ce fichier depuis le menu MCP de Cascade pour voir son emplacement dans votre version) :

{
  "mcpServers": {
    "twexapi": {
      "serverUrl": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Autres clients

Tout client qui implémente l’autorisation MCP (OAuth 2.1 avec PKCE et enregistrement dynamique des clients) peut se connecter en ajoutant seulement l’URL du serveur. Sinon, envoyez votre clé API avec l’en-tête x-api-key ou Authorization: Bearer YOUR_API_KEY. Si vous créez votre propre client, consultez OAuth pour les clients MCP.

Vérifier la connexion

• Le serveur affiche explore, twexapi_request et twexapi_write. twexapi_write n’apparaît pas si vous n’avez pas l’accès en écriture.
• Demandez à votre agent : « Utilise TwexAPI explore pour trouver les endpoints de tendances. » explore ne consomme aucun crédit : il fonctionne donc avant toute recharge.
• La nouvelle connexion apparaît sous Authorized apps (applications autorisées) dans le tableau de bord.

Lorsque vous signalez un problème, indiquez le nom et la version du client, l’heure UTC et, si vous pouvez le voir, l’en-tête de réponse X-Request-Id.