DokuMit Alran arbeiten
MCP-Server
Schließ eigene Werkzeuge und Dienste über das Model Context Protocol an, pro Projekt.
Wie füge ich einen MCP-Server hinzu?
Leg .mcp.json in dem Ordner an, aus dem du Alran startest:
{
"mcpServers": {
"research": {
"type": "http",
"url": "https://example.com/mcp",
"headers": { "Authorization": "Bearer ${RESEARCH_MCP_API_KEY}" }
}
}
}${RESEARCH_MCP_API_KEY} wird aus der Umgebung der Shell gelesen, die Alran startet, der Schlüssel bleibt also aus der Datei heraus:
read -r -s -p 'Research MCP API key: ' RESEARCH_MCP_API_KEY
export RESEARCH_MCP_API_KEY
alranNur der Haupt-Arbeitsordner wird nach .mcp.json durchsucht, nicht die Ordner darüber.
Prüfen
/mcp listet die Server und ihren Zustand (configured, available oder error); /mcp research filtert. Bitte Alran, ein Werkzeug des Servers mit einer kleinen Eingabe zu nutzen, und sieh dir den Aufruf mit Ctrl+O an. Nach Änderungen an .mcp.json hilft /mcp reload.
Ein angeschlossener Server sieht den Arbeitsordner und die Argumente jedes Werkzeugaufrufs. Schließ nur Dienste an, denen du vertraust.
Aus einem Plugin
Auch Plugins können MCP-Server mitbringen, im Alran-, Claude-Code- und Codex-Format. Siehe Plugins.
Häufige Fragen
Wie füge ich einem Projekt einen MCP-Server hinzu?
Leg eine Datei .mcp.json in dem Ordner an, aus dem du Alran startest, und trage den Server unter mcpServers mit Typ, URL und Headern ein. Geheimnisse gehören in Umgebungsvariablen, die du in den Headern referenzierst, damit der Schlüssel nicht in der Datei steht. Nur der Haupt-Arbeitsordner wird geprüft, nicht die Ordner darüber.
Wie prüfe ich, ob mein MCP-Server verbunden ist?
Der Befehl /mcp listet die Server und ihren Zustand, configured, available oder error, und /mcp research filtert die Liste nach Namen. Nach Änderungen an .mcp.json hilft /mcp reload.
Was sieht ein angeschlossener MCP-Server?
Ein angeschlossener Server sieht den Arbeitsordner und die Argumente jedes Werkzeugaufrufs, schließ also nur Dienste an, denen du vertraust. Plugins können MCP-Server ebenfalls mitbringen, im Alran-, Claude-Code- und Codex-Format.