---
name: connect-mcp
description: Claude Desktop, Claude Code, ChatGPT, Cursor oder Windsurf mit dem MCP-Server von Ökotrophologie Jobs verbinden, für Live-Abfragen von Stellen und Gehältern.
---

# connect-mcp

Einen MCP-Client mit dem MCP-Server von Ökotrophologie Jobs verbinden. Der Server stellt drei Tools bereit (`search_jobs`, `get_job`, `get_salaries`) über Streamable HTTP, ohne Authentifizierung.

## Server-URL

```
https://oekotrophologie-jobs.de/api/mcp
```

Dieselbe URL für jeden Client. Transport ist Streamable HTTP (MCP-Spezifikation 2025-03-26). Kein API-Key, kein OAuth, keine Allowlist.

## Claude Desktop

1. Einstellungen, dann Connectors.
2. Custom Connector hinzufügen.
3. Die Server-URL oben einfügen.
4. OAuth-Felder leer lassen.
5. Hinzufügen, dann Claude Desktop neu starten.
6. Neuer Chat. Die Tool-Liste zeigt `search_jobs`, `get_job`, `get_salaries`.

## Claude Code

```bash
claude mcp add --transport http oekotrophologie-jobs https://oekotrophologie-jobs.de/api/mcp
```

## ChatGPT

1. Einstellungen, Connectors, Advanced. Developer Mode aktivieren.
2. Einstellungen, Connectors, neuen Connector hinzufügen.
3. Name: Ökotrophologie Jobs.
4. MCP Server URL: `https://oekotrophologie-jobs.de/api/mcp`.
5. Authentifizierung: keine.
6. Erstellen. ChatGPT prüft die Verbindung und listet die Tools.
7. Neuer Chat. Auf + klicken, Ökotrophologie Jobs aktivieren.

## Cursor

In `~/.cursor/mcp.json` (oder dem projektbezogenen Pendant) ergänzen:

```json
{
  "mcpServers": {
    "oekotrophologie-jobs": {
      "url": "https://oekotrophologie-jobs.de/api/mcp"
    }
  }
}
```

## Windsurf

In der Windsurf-MCP-Konfiguration ergänzen:

```json
{
  "mcpServers": {
    "oekotrophologie-jobs": {
      "serverUrl": "https://oekotrophologie-jobs.de/api/mcp"
    }
  }
}
```

## Bereitgestellte Tools

- `search_jobs`: aktive Stellenangebote filtern. Drei Taxonomie-Parameter mit deutschen Slug-Werten: `agenticFrameworks` (Fachbereiche), `aiInfrastructure` (Arbeitgeber-Typen), `techStack` (Qualifikationen). Die Slug-Listen stehen im Skill `search-jobs`.
- `get_job`: vollständiges Stellenangebot per Slug, inklusive `descriptionHtml`.
- `get_salaries`: Gehaltsauswertungen je Dimension (overview, country = Bundesland, infrastructure = Arbeitgeber-Typ, tech-stack = Qualifikation, framework = Fachbereich, seniority, location-type). Details im Skill `get-salaries`.

Rate-Limit pro Tool: 60 Anfragen / 60 s / IP.

## Maschinenlesbare Metadaten

- MCP Server Card (SEP-1649): `https://oekotrophologie-jobs.de/.well-known/mcp/server-card.json`
- API-Katalog (RFC 9727): `https://oekotrophologie-jobs.de/.well-known/api-catalog`
- OpenAPI-3.1-Spezifikation der REST-API: `https://oekotrophologie-jobs.de/api/v1/openapi.json`

## Fehlerbehebung

- **Tool-Liste nach dem Verbinden leer**: Client neu starten; manche Clients cachen den Connector-Status.
- **Suche liefert null Ergebnisse**: Der Filterwert steckt vermutlich im falschen Parameter. `qualitaetsmanagement` ist ein Fachbereich (`agenticFrameworks`), `haccp` eine Qualifikation (`techStack`), `lebensmittelindustrie` ein Arbeitgeber-Typ (`aiInfrastructure`). Freitext gehört in `q`.
- **429-Fehler**: Der Server limitiert pro Tool und IP. Kurz warten und erneut versuchen.