MCP

Neleto unterstützt das Model Context Protocol (MCP), mit dem KI-Agenten - wie GitHub Copilot, Claude oder Cursor - über natürliche Sprache direkt mit deinem CMS interagieren können.

Verbundene Agenten können Inhalte lesen und schreiben: Seiten erstellen, Dateien verwalten, Blogbeiträge aktualisieren, Events auflisten und vieles mehr - alles direkt aus dem Editor heraus.

Endpunkt

Deine Neleto-Instanz stellt einen JSON-RPC 2.0 MCP-Endpunkt bereit:

POST <deine-neleto-url>/api/mcp

Authentifizierung

Alle Anfragen benötigen einen Bearer-Token. API-Tokens kannst du im Neleto-Admin unter Einstellungen -> API-Tokens erstellen.

Authorization: Bearer <dein-token>

Für Tools, die den OAuth-Ablauf automatisch durchführen (wie Claude Custom Connectors), siehe Claude Custom Connector (OAuth) weiter unten.

Claude Custom Connector (OAuth)

Claudes Custom Connectors (claude.ai und Claude Desktop) authentifizieren sich bei entfernten MCP-Servern per OAuth 2.1 statt mit einem manuell eingefügten Token. Neleto ist ein integrierter OAuth-2.1-Autorisierungsserver, daher ist keine Token-Einrichtung nötig: Claude registriert sich automatisch und du musst dich nur anmelden und die Verbindung bestätigen.

1. Öffne in Claude Einstellungen -> Connectors -> Custom Connector hinzufügen.
2. Gib die URL deines MCP-Endpunkts ein: https://deine-neleto-instanz.com/api/mcp
3. Claude ermittelt den Autorisierungsserver und öffnet deine Neleto-Instanz im Browser. Melde dich an (falls noch nicht geschehen) und bestätige den Anwendung verbinden-Dialog.
4. Claude wird zurückgeleitet und erhält automatisch ein Access-Token. Der Connector ist nun einsatzbereit.

Im Hintergrund stellt Neleto die standardisierten Discovery- und OAuth-Endpunkte bereit:

• GET /.well-known/oauth-protected-resource (RFC 9728)
• GET /.well-known/oauth-authorization-server (RFC 8414)
• POST /api/oauth/register — Dynamic Client Registration (RFC 7591)
• GET /api/oauth/authorize und POST /api/oauth/token — Authorization-Code-Flow mit PKCE

Ausgestellte Access-Tokens sind kurzlebig und werden automatisch erneuert. Jede Autorisierung ist an den bestätigenden Benutzer gebunden und erbt dessen Berechtigungen.

Verbundene Anwendungen verwalten

Du kannst OAuth-Verbindungen im Neleto-Admin unter Profil -> Sicherheit -> Verbundene Anwendungen einsehen und widerrufen. Beim Widerruf werden die Access- und Refresh-Tokens der Anwendung sofort ungültig.

Konfiguration

VS Code (GitHub Copilot Agent Mode)

Erstelle oder aktualisiere .vscode/mcp.json in deinem Projekt:

{
    "servers": {
        "neleto": {
            "type": "http",
            "url": "https://deine-neleto-instanz.com/api/mcp",
            "headers": {
                "Authorization": "Bearer <dein-token>"
            }
        }
    }
}

Diese Konfiguration kannst du auch in deinen VS Code Benutzereinstellungen (JSON) unter dem mcp-Schlüssel eintragen, damit sie projektübergreifend gilt.

Claude Desktop

Claude Desktop unterstützt HTTP-MCP-Server nicht nativ, aber du kannst mcp-remote als Proxy verwenden. Füge folgendes zur Claude Desktop Konfigurationsdatei (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS) hinzu:

{
    "mcpServers": {
        "neleto": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://deine-neleto-instanz.com/api/mcp",
                "--header",
                "Authorization:Bearer <dein-token>"
            ]
        }
    }
}

Cursor

Öffne in Cursor Einstellungen -> Features -> MCP Servers und füge einen neuen Server hinzu:

{
    "neleto": {
        "type": "http",
        "url": "https://deine-neleto-instanz.com/api/mcp",
        "headers": {
            "Authorization": "Bearer <dein-token>"
        }
    }
}

OpenCode

Füge den Server in ~/.config/opencode/opencode.json unter dem mcp-Schlüssel hinzu:

{
    "mcp": {
        "neleto": {
            "type": "remote",
            "url": "https://deine-neleto-instanz.com/api/mcp",
            "headers": {
                "Authorization": "Bearer <dein-token>"
            }
        }
    }
}

Windsurf

Füge den Server in ~/.codeium/windsurf/mcp_config.json unter dem mcpServers-Schlüssel hinzu:

{
    "mcpServers": {
        "neleto": {
            "serverUrl": "https://deine-neleto-instanz.com/api/mcp",
            "headers": {
                "Authorization": "Bearer <dein-token>"
            }
        }
    }
}

Protokolldetails

Der MCP-Endpunkt verwendet JSON-RPC 2.0. Tool-Aufrufe verwenden die Methode tools/call:

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "page_list",
        "arguments": {
            "limit": 10
        }
    }
}

Eine vollständige Liste aller verfügbaren Tools findest du auf der Seite Tools-Referenz.