Configuration MCP de Cascade

​

Ajouter un nouveau MCP

​

Configuration des outils MCP

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "disabledTools": ["create_repository"]
    }
  }
}

​

mcp_config.json

• macOS / Linux : ~/.config/devin/mcp_config.json (ou $XDG_CONFIG_HOME/devin/mcp_config.json si XDG_CONFIG_HOME est défini)
• Windows : %APPDATA%\devin\mcp_config.json

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}

​

Exemples de serveurs MCP populaires

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>",
        "SLACK_TEAM_ID": "<YOUR_SLACK_TEAM_ID>"
      }
    }
  }
}

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://user:password@localhost:5432/database"
      }
    }
  }
}

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y", "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    }
  }
}

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "<YOUR_BRAVE_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

​

MCP HTTP distants

{
  "mcpServers": {
    "remote-http-mcp": {
      "serverUrl": "<your-server-url>/mcp",
      "headers": {
        "API_KEY": "value"
      }
    }
  }
}

​

Interpolation de configuration

• ${env:VAR_NAME} — remplacé par la valeur de la variable d’environnement VAR_NAME. Si la variable n’est pas définie, il est remplacé par une chaîne vide.
• ${file:/path/to/file} — remplacé par le contenu du fichier au chemin indiqué, après suppression des espaces superflus en début et fin de contenu. Les chemins avec tilde (p. ex. ~/secrets/key.txt) sont pris en charge. Si le fichier ne peut pas être lu, le motif reste inchangé.

{
  "mcpServers": {
    "remote-http-mcp": {
      "serverUrl": "<your-server-url>/mcp",
      "headers": {
        "API_KEY": "Bearer ${env:AUTH_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "API_KEY": "${file:~/.secrets/api_key.txt}"
      }
    }
  }
}

​

Contrôles d’administration (Teams et Enterprise)

​

Registre MCP

​

Configuration de registres personnalisés

1. Accédez aux paramètres de votre équipe
2. Recherchez le paramètre MCP Registry URLs
3. Ajoutez une ou plusieurs URL de registre

​

Liste d’autorisation MCP

​

Comment fonctionne la correspondance des serveurs

• Correspondance sur l’intégralité de la chaîne : tous les motifs sont automatiquement ancrés (entourés de ^(?:pattern)$) afin d’empêcher les correspondances partielles
• Champ de commande : doit correspondre exactement ou selon votre motif regex
• Tableau d’arguments : chaque argument est comparé individuellement au motif correspondant
• Longueur du tableau : le nombre d’arguments doit correspondre exactement entre la liste d’autorisation et la configuration de l’utilisateur
• Caractères spéciaux : des caractères comme $, ., [, ], (, ) ont une signification particulière en regex et doivent être échappés avec \ si vous voulez une correspondance littérale

​

Options de configuration

{}

{
  "mcpServers": {
    "github-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "GITHUB_PERSONAL_ACCESS_TOKEN",
    "ghcr.io/github/github-mcp-server"
  ],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": ""
  }
}

{
  "mcpServers": {
    "github-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

{
  "command": "python3",
  "args": ["/.*\\.py", "--port", "[0-9]+"]
}

{
  "mcpServers": {
    "python-mcp-server": {
      "command": "python3",
      "args": ["/home/user/my_server.py", "--port", "8080"],
      "env": {
        "PYTHONPATH": "/home/user/mcp"
      }
    }
  }
}

​

Motifs regex courants

​

Notes

​

Consignes de configuration pour les administrateurs

• Variables d’environnement : la section env ne fait pas l’objet d’une correspondance par regex et peut être configurée librement par les utilisateurs
• Outils désactivés : le tableau disabledTools est traité séparément et ne fait pas partie de la correspondance avec la liste d’autorisation
• Sensibilité à la casse : toute correspondance est sensible à la casse
• Gestion des erreurs : les motifs regex non valides seront consignés dans les journaux et entraîneront un refus d’accès
• Tests : testez soigneusement vos motifs regex - des motifs trop restrictifs peuvent bloquer des cas d’usage légitimes

​

Dépannage

1. Vérifier la correspondance exacte : assurez-vous que le motif de la liste d’autorisation correspond exactement à la configuration de l’utilisateur
2. Vérifier l’échappement des regex : les caractères spéciaux peuvent devoir être échappés (p. ex., \. pour un point littéral)
3. Consulter les logs : les motifs regex non valides sont enregistrés avec un avertissement
4. Tester les motifs : utilisez un testeur regex pour vérifier que vos motifs fonctionnent comme prévu

​

Informations générales

• Comme les appels d’outils MCP peuvent invoquer du code écrit par n’importe quel implémenteur de serveur, nous déclinons toute responsabilité en cas d’échec des appels d’outils MCP. En d’autres termes :
• Nous prenons actuellement en charge les outils, les ressources et les prompts d’un serveur MCP.