Connecter un assistant externe

Utilisez ce guide si vous voulez que votre propre assistant, comme Codex, Claude, Cursor, Windsurf, VS Code, Gemini CLI ou un autre client compatible MCP, travaille avec votre compte TheoryCraft.

Avant de commencer

Ouvrez le workspace TheoryCraft que l'assistant doit utiliser, puis allez dans Settings -> Developer.

Copiez l'endpoint MCP affiche. Les exemples ci-dessous utilisent :

https://beta.theorycraft-trading.ai/mcp

Si votre page settings affiche un endpoint different, utilisez celui affiche dans vos settings.

Si vous voulez que l'assistant interagisse avec votre session TheoryCraft actuelle, gardez TheoryCraft ouvert dans votre navigateur.

Choisir l'acces

TheoryCraft supporte deux methodes de connexion :

Methode	Ideale pour
Connexion avec TheoryCraft	Les clients qui ouvrent une connexion via navigateur, comme les connecteurs Claude.ai ou le login OAuth de Codex.
Token personnel	Les clients qui vous demandent de coller un token ou d'en lire un depuis une variable d'environnement.

Quand vous creez un token personnel, choisissez le niveau d'acces le plus limite possible :

Acces	Autorise
Lecture seule	L'assistant peut lire des informations depuis votre compte TheoryCraft.
Lecture/ecriture	L'assistant peut aussi effectuer des actions dans TheoryCraft quand vous le lui demandez.

Installer les skills TheoryCraft

Installez le bundle de skills TheoryCraft pour que votre assistant comprenne les workflows et le vocabulaire TheoryCraft. Installez-le une fois par client ou par machine ou vous utilisez l'assistant.

URL du bundle :

https://beta.theorycraft-trading.ai/mcp/skills/theorycraft-skills.zip

Codex

macOS et Linux :

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
curl -fsSL https://beta.theorycraft-trading.ai/mcp/skills/theorycraft-skills.zip -o /tmp/tc-skills.zip
unzip -o /tmp/tc-skills.zip -d "${CODEX_HOME:-$HOME/.codex}/skills"
rm -f /tmp/tc-skills.zip

Windows PowerShell :

$dest = "$env:USERPROFILE\.codex\skills"
New-Item -ItemType Directory -Force $dest
Invoke-WebRequest "https://beta.theorycraft-trading.ai/mcp/skills/theorycraft-skills.zip" -OutFile "$env:TEMP\tc-skills.zip"
Expand-Archive -Force "$env:TEMP\tc-skills.zip" $dest
Remove-Item -Force "$env:TEMP\tc-skills.zip"

Claude Code

Claude Code supporte les skills personnels dans ~/.claude/skills et les skills de projet dans .claude/skills. Utilisez les skills personnels si vous voulez TheoryCraft disponible dans tous vos projets.

macOS et Linux :

mkdir -p "$HOME/.claude/skills"
curl -fsSL https://beta.theorycraft-trading.ai/mcp/skills/theorycraft-skills.zip -o /tmp/tc-skills.zip
unzip -o /tmp/tc-skills.zip -d "$HOME/.claude/skills"
rm -f /tmp/tc-skills.zip

Windows PowerShell :

$dest = "$env:USERPROFILE\.claude\skills"
New-Item -ItemType Directory -Force $dest
Invoke-WebRequest "https://beta.theorycraft-trading.ai/mcp/skills/theorycraft-skills.zip" -OutFile "$env:TEMP\tc-skills.zip"
Expand-Archive -Force "$env:TEMP\tc-skills.zip" $dest
Remove-Item -Force "$env:TEMP\tc-skills.zip"

Pour des skills limites a un projet, extrayez le ZIP dans .claude/skills a la racine du projet. Si Claude Code tournait deja et que le dossier de skills n'existait pas encore, redemarrez Claude Code ; sinon il detecte les changements automatiquement.

Reference : skills Claude Code.

Skills Claude.ai

Claude.ai gere les skills depuis son interface de settings. Le bundle TheoryCraft contient plusieurs dossiers de skills, alors que l'upload Claude.ai attend un ZIP par dossier de skill. Pour utiliser les memes skills, telechargez le bundle, extrayez-le, creez un ZIP separe pour chaque dossier theorycraft-*, puis uploadez ces ZIPs depuis les settings Skills de Claude.

Si vous voulez seulement que Claude.ai appelle les outils TheoryCraft, sautez l'upload des skills et utilisez la configuration du connecteur Claude.ai plus bas.

Reference : skills custom Claude.ai.

Gemini CLI

Gemini CLI supporte les Agent Skills dans ~/.gemini/skills pour un usage global et dans .gemini/skills pour un usage limite a un projet.

macOS et Linux :

mkdir -p "$HOME/.gemini/skills"
curl -fsSL https://beta.theorycraft-trading.ai/mcp/skills/theorycraft-skills.zip -o /tmp/tc-skills.zip
unzip -o /tmp/tc-skills.zip -d "$HOME/.gemini/skills"
rm -f /tmp/tc-skills.zip
gemini skills list

Windows PowerShell :

$dest = "$env:USERPROFILE\.gemini\skills"
New-Item -ItemType Directory -Force $dest
Invoke-WebRequest "https://beta.theorycraft-trading.ai/mcp/skills/theorycraft-skills.zip" -OutFile "$env:TEMP\tc-skills.zip"
Expand-Archive -Force "$env:TEMP\tc-skills.zip" $dest
Remove-Item -Force "$env:TEMP\tc-skills.zip"
gemini skills list

Dans une session Gemini CLI deja ouverte, lancez /skills reload apres avoir installe ou mis a jour le bundle.

Reference : commandes skills Gemini CLI.

Cursor, Windsurf, VS Code, Continue et autres clients

Tous les clients MCP n'ont pas un systeme local SKILL.md. Cursor, Windsurf, VS Code et Continue documentent surtout la configuration de serveurs MCP : connectez-les a l'endpoint MCP TheoryCraft et laissez les descriptions d'outils guider l'assistant. Si votre client ajoute plus tard un support SKILL.md natif, extrayez le ZIP dans le dossier de skills documente par ce client.

Connecter votre client

Codex

Codex avec connexion navigateur

export TC_MCP_URL="https://beta.theorycraft-trading.ai/mcp"
codex mcp add theorycraft --url "$TC_MCP_URL" --oauth-resource "$TC_MCP_URL"
codex mcp login theorycraft --scopes mcp:read,mcp:write

Codex avec token personnel

Creez un token personnel dans Settings -> Developer, puis stockez-le dans une variable d'environnement.

macOS et Linux :

export TC_MCP_URL="https://beta.theorycraft-trading.ai/mcp"
export THEORYCRAFT_MCP_TOKEN="coller-le-token"
codex mcp add theorycraft --url "$TC_MCP_URL" --bearer-token-env-var THEORYCRAFT_MCP_TOKEN

Windows PowerShell :

$env:TC_MCP_URL = "https://beta.theorycraft-trading.ai/mcp"
setx THEORYCRAFT_MCP_TOKEN "coller-le-token"
codex mcp add theorycraft --url $env:TC_MCP_URL --bearer-token-env-var THEORYCRAFT_MCP_TOKEN

Redemarrez le terminal apres setx pour que la nouvelle variable d'environnement soit disponible.

Claude Code

Claude Code avec connexion navigateur

Ajoutez le serveur MCP HTTP distant, puis lancez /mcp dans Claude Code pour terminer la connexion via navigateur.

export TC_MCP_URL="https://beta.theorycraft-trading.ai/mcp"
claude mcp add --transport http --scope user theorycraft "$TC_MCP_URL"
claude

Dans Claude Code :

/mcp

Claude Code avec token personnel

Creez un token personnel dans Settings -> Developer, puis passez-le comme header HTTP d'autorisation.

export THEORYCRAFT_MCP_TOKEN="coller-le-token"
claude mcp add --transport http --scope user \
  --header "Authorization: Bearer $THEORYCRAFT_MCP_TOKEN" \
  theorycraft "https://beta.theorycraft-trading.ai/mcp"

Gemini CLI

Gemini CLI avec connexion navigateur

Ajoutez TheoryCraft comme serveur MCP HTTP au scope utilisateur. Gemini CLI ouvre le flux d'authentification navigateur quand le serveur demande OAuth.

export TC_MCP_URL="https://beta.theorycraft-trading.ai/mcp"
gemini mcp add --transport http --scope user theorycraft "$TC_MCP_URL"
gemini mcp list

Gemini CLI avec token personnel

Creez un token personnel dans Settings -> Developer, puis passez-le comme header HTTP d'autorisation.

export TC_MCP_URL="https://beta.theorycraft-trading.ai/mcp"
export THEORYCRAFT_MCP_TOKEN="coller-le-token"
gemini mcp add --transport http --scope user \
  --header "Authorization: Bearer $THEORYCRAFT_MCP_TOKEN" \
  theorycraft "$TC_MCP_URL"

Connecteur Claude.ai

Creez un connecteur custom et choisissez la connexion via navigateur.

Utilisez ces valeurs quand Claude les demande :

MCP server URL: <l'endpoint MCP affiche dans Settings -> Developer>
Resource URL: <le meme endpoint MCP>
Permissions: lecture/ecriture si vous voulez que Claude effectue des actions dans TheoryCraft, sinon lecture seule

Cursor

Ajoutez TheoryCraft a .cursor/mcp.json pour un projet, ou a votre configuration MCP utilisateur si vous voulez l'utiliser partout.

{
  "mcpServers": {
    "theorycraft": {
      "type": "http",
      "url": "https://beta.theorycraft-trading.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THEORYCRAFT_MCP_TOKEN}"
      }
    }
  }
}

Reference : configuration MCP Cursor.

Windsurf

Ouvrez la configuration MCP brute de Cascade dans Windsurf et ajoutez un serveur HTTP distant. Windsurf utilise serverUrl pour les entrees MCP HTTP distantes.

{
  "mcpServers": {
    "theorycraft": {
      "serverUrl": "https://beta.theorycraft-trading.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THEORYCRAFT_MCP_TOKEN}"
      }
    }
  }
}

Reference : Windsurf Cascade MCP.

VS Code

Utilisez la commande MCP: Open User Configuration depuis la palette de commandes, ou creez .vscode/mcp.json dans un workspace. VS Code utilise un objet racine servers, pas mcpServers.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "theorycraft-token",
      "description": "TheoryCraft MCP token",
      "password": true
    }
  ],
  "servers": {
    "theorycraft": {
      "type": "http",
      "url": "https://beta.theorycraft-trading.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${input:theorycraft-token}"
      }
    }
  }
}

Reference : configuration MCP VS Code.

Continue et autres clients JSON MCP

Utilisez la configuration MCP distante ou HTTP MCP supportee par votre client. Les labels changent selon le produit, mais les valeurs sont :

Name: theorycraft
URL: <l'endpoint MCP affiche dans Settings -> Developer>
Methode de connexion: connexion navigateur, ou token personnel
Resource URL, si demande: <le meme endpoint MCP>

Si votre client demande une configuration JSON et supporte les variables d'environnement, utilisez :

{
  "mcpServers": {
    "theorycraft": {
      "type": "http",
      "url": "https://beta.theorycraft-trading.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${THEORYCRAFT_MCP_TOKEN}"
      }
    }
  }
}

Pour la connexion via navigateur, retirez le bloc headers et utilisez les champs de connexion affiches par votre client.

Garder l'acces securise

Creez un token separe pour chaque client.
Preferez la lecture seule sauf si vous voulez que l'assistant effectue des actions dans TheoryCraft.
Ajoutez une date d'expiration pour les appareils temporaires.
Revoquez les tokens inutilises depuis Settings -> Developer.
Ne collez jamais un token personnel dans un repo partage, une issue, un transcript de chat ou une bibliotheque de prompts.