Praxicraft Assess MCP

Offizieller Model Context Protocol-Server für die Praxicraft Assess Public API.

Verbinden Sie Cursor, Claude Code, Claude Desktop, Codex oder einen beliebigen MCP-Client, damit ein Agent Kandidaten einladen, Bewertungen und Pipelines verwalten, Webhooks registrieren und Ergebnisse abrufen kann – mit Ihrer Erlaubnis.

npx -y @praxicraft/assess-mcp

Erfordert Node.js 18+. Produktdokumentation: docs.praxicraft.com/assess-mcp · Mit Agenten bauen

Bevorzugen Sie eine einzige Installation für API-MCP + Dokumentsuche + Fähigkeiten? Verwenden Sie das Assess Agent Plugin.

Inhaltsverzeichnis

• Zwei Verbindungsmöglichkeiten

• Authentifizierung

• Schnellstart

  • Gehostetes HTTP (Cursor / Claude Code)

  • Stdio (API-Schlüssel)

• Was Agenten tun können

• Live- vs. Testmodus

• Fehler

• Anforderungen & Support

• Lizenz

Related MCP server: Oktopost MCP Server

Zwei Verbindungsmöglichkeiten

Gehostetes OAuth ist der einfachste Weg in Cursor und Claude. Verwenden Sie stdio, wenn Sie einen ct_test_-Schlüssel oder eine nicht-interaktive Umgebung benötigen.

Authentifizierung

Gehostet (OAuth)

Kein API-Schlüssel in Ihrer Konfiguration. Der erste Tool-Aufruf öffnet einen Browser-Zustimmungsbildschirm. Eigentümer, Administratoren und Entwickler können genehmigen.

Gehostete Sitzungen sind immer im Live-Modus.

Stdio (API-Schlüssel)

Erstellen Sie einen Organisations-API-Schlüssel:

Assess → Developer → API Keys → Schlüssel erstellen → ct_live_… oder ct_test_… kopieren (wird einmal angezeigt).

export PRAXICRAFT_API_KEY="ct_test_xxxxxxxxxxxxxxxx"
# optional
export PRAXICRAFT_API_BASE_URL="https://assess.praxicraft.com"

Committen Sie niemals API-Schlüssel. Bevorzugen Sie Umgebungsvariablen oder einen Secrets-Manager.

IP-Allowlists für API-Schlüssel gelten für Public-API-/stdio-MCP-Anfragen. Sie gelten nicht für gehostetes OAuth. Verwenden Sie für stdio einen dedizierten Schlüssel mit leerer Allowlist, wenn andere Schlüssel CIDR-beschränkt sind.

Bereiche und Rotation: Authentifizierung

Empfohlene Bereiche

Schnellstart

Gehostetes HTTP (Cursor / Claude Code)

Fügen Sie zu Ihren MCP-Einstellungen hinzu:

{
  "mcpServers": {
    "praxicraft-assess": {
      "url": "https://assess.praxicraft.com/mcp"
    }
  }
}

Claude Code Beispiel:

{
  "mcpServers": {
    "praxicraft-assess": {
      "type": "http",
      "url": "https://assess.praxicraft.com/mcp"
    }
  }
}

Starten Sie den Client neu und versuchen Sie dann: „Listen Sie meine Assess-Bewertungen auf und laden Sie mich zur ersten aktiven ein.“

Stdio (API-Schlüssel)

{
  "mcpServers": {
    "praxicraft-assess": {
      "command": "npx",
      "args": ["-y", "@praxicraft/assess-mcp"],
      "env": {
        "PRAXICRAFT_API_KEY": "ct_test_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Aus dem Quellcode (Mitwirkende):

git clone https://github.com/praxicraft-platform/praxicraft-assess-mcp.git
cd praxicraft-assess-mcp
npm ci
npm test
npm run smoke

Was Agenten tun können

Tools bilden die Assess Public API (/api/v1/public/…) ab. Die Abdeckung umfasst:

Antworten sind flaches JSON (gleiche Form wie die Public API – kein { "data": … }-Wrapper).

Erinnern Sie Agenten daran, Planlimits zu respektieren und auf error.code zu verzweigen.

Live- vs. Testmodus

Ein Test-candidate.passed erreicht niemals ein Live-Slack- oder HTTPS-Ziel. Siehe Live- und Testmodus.

Fehler

Public-API-Fehler sehen so aus:

{ "error": { "code": "SOME_CODE", "message": "…", "details": {} } }

Verzweigen Sie immer auf error.code. Referenz: Fehler

Anforderungen & Support

• Node.js 18+ (stdio-Paket)

• Assess-Plan, der API-Schlüssel enthält (siehe Planlimits)

• Produktdokumentation: docs.praxicraft.com

• Agent-Plugin (API + Docs-Wissens-MCP + Fähigkeiten): praxicraft-assess-agent-plugin

• Probleme: GitHub Issues

• E-Mail: support@praxicraft.com

Betreuer, die den gehosteten /mcp-Dienst bereitstellen: siehe DEPLOYMENT.md.

Lizenz

MIT