MCP pour les agents IA

Railyard fait tourner un serveur Model Context Protocol à https://app.railyard.run/api/mcp, en streamable HTTP. Il utilise les mêmes jetons API que la CLI et l’API REST, donc un agent ne peut faire que ce que son jeton permet, rien de plus.

Connecter un agent

Créez un jeton sous Settings → Team → API tokens. Utilisez un jeton read si l’agent a seulement besoin de consulter. Ensuite :

Claude Code

claude mcp add --transport http railyard https://app.railyard.run/api/mcp --header "Authorization: Bearer rly_..."

Cursor (.cursor/mcp.json)

{ "mcpServers": { "railyard": { "url": "https://app.railyard.run/api/mcp", "headers": { "Authorization": "Bearer rly_..." } } } }

N’importe quel autre client MCP qui parle streamable HTTP et qui peut envoyer un en-tête Authorization fonctionne de la même façon.

Outils

Outil	Jeton	Ce que ça fait
list_servers	read	Les serveurs de l’équipe
list_apps	read	Les applications de l’équipe
get_app	read	Les détails d’une application
app_logs	read	Les lignes de log récentes d’une application (100 par défaut, jusqu’à 500)
deploy_app	write	Déploie une application, selon les mêmes règles d’approbation et la même limite de fréquence que le tableau de bord
restart_app	write	Redémarre une application
set_env	write	Définit une variable d’environnement (elle s’applique au prochain déploiement)
unset_env	write, approval	Supprime une variable
delete_app	write, approval	Supprime une application

Approbations

Supprimer une variable ou une application ne s’exécute jamais directement depuis un agent. Cela crée une demande sur la page Approvals, qui s’affiche aussi sur le tableau de bord, et rien ne change jusqu’à ce qu’un admin de l’équipe l’approuve. Approuver exécute l’action et enregistre le résultat. Rejeter l’annule.

Bonnes pratiques

• Donnez à chaque agent son propre jeton avec une date d’expiration, et révoquez-le une fois terminé.
• Utilisez un jeton read pour les agents qui ne font que répondre à des questions (« pourquoi le paiement est-il lent? »).
• Les déploiements qu’un agent démarre passent par l’approbation de déploiement et la limite de fréquence de l’application, comme n’importe quel autre déploiement.

Limites

Le serveur MCP couvre les actions ci-dessus. Pour tout le reste, comme les serveurs, les domaines ou les bases de données, passez par l’API REST ou la CLI.