YouTube MCP Connector für Claude.ai

Produktionsreifer Remote-MCP-Server, der es Claude.ai ermöglicht, über HTTPS schreibgeschützte YouTube-Tools zu nutzen:

• search_videos

• get_trending_videos

• get_channel_videos

• get_video_details

• get_engagement_stats

• get_transcript

• search_transcript

Der Dienst verwendet die offizielle YouTube Data API v3 für Suche, Metadaten, Trend-Videos und Kanal-Uploads. Der Transkriptabruf erfolgt nach dem Best-Effort-Prinzip: Zuerst werden öffentliche InnerTube-Untertitelspuren probiert, danach die Untertitelermittlung über die YouTube-Watch-Seite. Er umgeht keine CAPTCHAs, Sperren oder Rate-Limits.

Lokale Einrichtung

npm install
cp .env.example .env

Setzen Sie mindestens:

YOUTUBE_API_KEY=your_google_api_key
AUTH_MODE=none

Lokal ausführen:

npm run dev

Health Checks:

curl http://localhost:3000/health
curl http://localhost:3000/ready

Erstellen und testen:

npm test
npm run build

Related MCP server: youtube-research

Produktionsumgebung

Minimale Railway-Testvariablen:

YOUTUBE_API_KEY=...
AUTH_MODE=none

Redis wird empfohlen, aber die App kann auch ohne Redis starten und verwendet dann einen prozessinternen No-op-Cache.

Vollständige Produktionsvariablen:

NODE_ENV=production
YOUTUBE_API_KEY=...
AUTH_MODE=oauth
AUTH_ISSUER=https://YOUR_AUTH0_DOMAIN/
AUTH_AUDIENCE=https://youtube-claude-mcp
AUTH_JWKS_URL=https://YOUR_AUTH0_DOMAIN/.well-known/jwks.json
AUTH_REQUIRED_SCOPE=youtube:read
REDIS_URL=...

Standard-Cache-TTLs:

TRANSCRIPT_CACHE_TTL_SECONDS=604800
VIDEO_DETAILS_CACHE_TTL_SECONDS=900
TRENDING_CACHE_TTL_SECONDS=600
CHANNEL_VIDEOS_CACHE_TTL_SECONDS=600

Auth0-Einrichtung

1. Erstellen Sie eine Auth0-API oder verwenden Sie eine vorhandene wieder.

2. Setzen Sie die API-Kennung auf denselben Wert wie AUTH_AUDIENCE.

3. Fügen Sie den Scope youtube:read hinzu.

4. Verwenden Sie die Auth0-Issuer-URL als AUTH_ISSUER.

5. Verwenden Sie den JWKS-Endpunkt des Tenants als AUTH_JWKS_URL.

6. Konfigurieren Sie die erweiterten OAuth-Einstellungen des benutzerdefinierten Connectors von Claude.ai mit den entsprechenden Auth0-Client-Daten.

Der /mcp-Endpunkt erfordert ein gültiges Authorization: Bearer <token>, wenn AUTH_MODE=oauth gesetzt ist.

Railway-Deployment

1. Pushen Sie das Repository auf GitHub.

2. Erstellen Sie ein Railway-Projekt aus dem GitHub-Repository.

3. Railway sollte das eingecheckte Dockerfile über railway.json verwenden.

4. Fügen Sie Servicevariablen hinzu:

YOUTUBE_API_KEY=...
AUTH_MODE=none

5. Stellen Sie die Anwendung bereit und öffnen Sie /health.

6. Fügen Sie später Railway Redis hinzu, wenn Sie gemeinsames Caching wünschen, und setzen Sie dann REDIS_URL.

7. Wechseln Sie zu Auth0, indem Sie AUTH_MODE=oauth und die Auth0-Variablen setzen.

Render-Deployment

1. Erstellen Sie eine Render-Redis-Instanz.

2. Erstellen Sie einen Render-Web-Service aus diesem Repository.

3. Wählen Sie das Docker-Deployment.

4. Fügen Sie die Produktionsumgebungsvariablen hinzu.

5. Stellen Sie bereit.

6. Überprüfen Sie:

curl https://YOUR_RENDER_URL/health
curl https://YOUR_RENDER_URL/ready
curl -i https://YOUR_RENDER_URL/mcp

Ein nicht authentifizierter Aufruf von /mcp sollte 401 zurückgeben.

Claude.ai-Connector

1. Öffnen Sie die Claude.ai-Einstellungen.

2. Gehen Sie zu Customize, dann zu Connectors.

3. Fügen Sie einen benutzerdefinierten Connector hinzu.

4. Verwenden Sie:

https://YOUR_RENDER_URL/mcp

5. Konfigurieren Sie die erweiterten OAuth-Einstellungen, wenn die Produktionsauthentifizierung aktiviert ist.

6. Aktivieren Sie den Connector in einem Chat.

Demo-Prompts:

• Suche auf YouTube nach 5 aktuellen MCP-Server-Tutorials.

• Welche Videos sind gerade in Pakistan am beliebtesten?

• Zeige die neuesten Videos von @GoogleDevelopers.

• Ermittle Aufrufe, Likes und Dauer für diese YouTube-URL.

• Berechne seine Engagement-Rate.

• Rufe das Transkript ab und fasse es zusammen.

• Wo im Transkript erwähnen sie die Authentifizierung?

Betriebshinweise

• Beschränken und rotieren Sie den YouTube-API-Schlüssel in Google Cloud, wo dies praktikabel ist.

• Protokollieren Sie keine API-Schlüssel, Bearer-Tokens oder vollständigen Autorisierungs-Header.

• Suchaufrufe verbrauchen viel Quota; bevorzugen Sie, wo möglich, Kanal-Uploads und zwischengespeicherte Metadaten.

• Redis-Ausfälle verschlechtern das Cache-Verhalten, lassen normale Tool-Aufrufe aber nicht fehlschlagen.

• Transkriptfehler können auftreten, wenn Untertitel deaktiviert, nicht verfügbar, regionsbeschränkt oder von YouTube blockiert sind.

• CAPTCHA- oder Bot-Block-Antworten werden als Fehler angezeigt; der Dienst versucht keine Umgehung.

Fehlerbehebung

• Der Start schlägt mit YOUTUBE_API_KEY is required fehl: Setzen Sie den serverseitigen API-Schlüssel.

• Der Start in der Produktion schlägt mit REDIS_URL is required fehl: Verbinden Sie Render Redis und setzen Sie dessen URL.

• /mcp gibt 401 zurück: Das Token fehlt, ist abgelaufen, fehlerhaft oder wurde vom falschen Issuer signiert.

• /mcp gibt 403 zurück: Das Token ist gültig, aber es fehlt der Scope youtube:read.

• Das Transkript-Tool gibt „nicht verfügbar“ zurück: Das Video hat möglicherweise keine öffentlichen Untertitel.

• YouTube-Quota überschritten: Warten Sie auf das Quota-Reset, beantragen Sie eine Quota-Erhöhung oder reduzieren Sie die Suchnutzung.