---
title: "MCP-Server · Alran-Code-Doku"
url: https://alran.dev/de/docs/mcp
locale: de
updated: 2026-11-16
---

[Doku](https://alran.dev/de/docs)Mit Alran arbeiten

# MCP-Server

Schließ eigene Werkzeuge und Dienste über das Model Context Protocol an, pro Projekt.

Auf dieser Seite

[Wie füge ich einen MCP-Server hinzu?](#add) [Prüfen](#check) [Aus einem Plugin](#plugins) [Häufige Fragen](#faq)

## Wie füge ich einen MCP-Server hinzu? {#add}

Leg `.mcp.json` in dem Ordner an, aus dem du Alran startest:

```json
{
  "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:

```bash
read -r -s -p 'Research MCP API key: ' RESEARCH_MCP_API_KEY
export RESEARCH_MCP_API_KEY
alran
```

Nur der Haupt-Arbeitsordner wird nach `.mcp.json` durchsucht, nicht die Ordner darüber.

## Prüfen {#check}

`/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 {#plugins}

Auch Plugins können MCP-Server mitbringen, im Alran-, Claude-Code- und Codex-Format. Siehe [Plugins](https://alran.dev/de/docs/plugins#local).

## Häufige Fragen {#faq}

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.

[ZurückPlugins, Skills und Hooks](https://alran.dev/de/docs/plugins) [WeiterHeadless und CI](https://alran.dev/de/docs/headless)
