Specshield MCP Server

Name: Specshield MCP Server
Author: specshield-io

von specshield-ioVersion 1.1.1i★ –iLäuft auf deinem Computer

Name in der Registryio.github.specshield-io/specshield-mcp-server

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

The API-change deploy gate for AI coding agents. Read-only breaking-change detection.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Entwicklertools
Das musst du eintragen: SPECSHIELD_API_KEY

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: SPECSHIELD_API_KEY, SPECSHIELD_API_URL, SPECSHIELD_TIMEOUT_MS, SPECSHIELD_LOG_LEVEL

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "specshield": {
      "command": "npx",
      "args": [
        "-y",
        "specshield-mcp-server"
      ],
      "env": {
        "SPECSHIELD_API_KEY": "your-value",
        "SPECSHIELD_API_URL": "your-value",
        "SPECSHIELD_TIMEOUT_MS": "your-value",
        "SPECSHIELD_LOG_LEVEL": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add specshield --env SPECSHIELD_API_KEY=your-value --env SPECSHIELD_API_URL=your-value --env SPECSHIELD_TIMEOUT_MS=your-value --env SPECSHIELD_LOG_LEVEL=your-value -- npx -y specshield-mcp-server

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "specshield": {
      "command": "npx",
      "args": [
        "-y",
        "specshield-mcp-server"
      ],
      "env": {
        "SPECSHIELD_API_KEY": "your-value",
        "SPECSHIELD_API_URL": "your-value",
        "SPECSHIELD_TIMEOUT_MS": "your-value",
        "SPECSHIELD_LOG_LEVEL": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "specshield": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "specshield-mcp-server"
      ],
      "env": {
        "SPECSHIELD_API_KEY": "your-value",
        "SPECSHIELD_API_URL": "your-value",
        "SPECSHIELD_TIMEOUT_MS": "your-value",
        "SPECSHIELD_LOG_LEVEL": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

SPECSHIELD_API_KEY geheim erforderlich env
SpecShield API key
SPECSHIELD_API_URL env
Backend base URL
SPECSHIELD_TIMEOUT_MS env
Per-request timeout (ms)
SPECSHIELD_LOG_LEVEL env
debug|info|warn|error

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 6. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto specshield-io bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Entwicklertoolsi

Mehr Sterne als 0 % der anderen 1389 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 42 % der anderen 1389 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 1389 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Specshield MCP Server sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: SPECSHIELD_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (1.1.1) kam vor 3 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: GitHub, Desktop Commander, Cloudflare MCP

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

GitHub

von github

Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

Computer oder Cloud★ 34.245MITAktualisiert vor 3 Tagen

Installieren

Desktop Commander

von wonderwhy-er

MCP server for terminal commands, file operations, and process management

Läuft auf deinem Computer★ 10.225MITAktualisiert vor 15 Tagen

Installieren

Cloudflare MCP

von cloudflare

Cloudflare MCP servers

Läuft in der Cloud★ 4.446Apache-2.0Aktualisiert vor 14 Monaten

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

SpecShield MCP Server

The API-change deploy gate for AI coding agents. Ask *"is it safe to ship this API change to my consumers?"* right inside Claude, Cursor, and other MCP clients — and catch breaking changes before they reach your consumers.

It's a thin adapter over the SpecShield backend. Every tool is read-only / analyze-only — it never modifies your code.

Why not just diff specs? Plenty of tools (including free ones) list breaking

changes. SpecShield's job is the *decision*: can I deploy this? — the deploy

gate is the hero tool here.

⚙️ In CI/CD instead of an agent? The specshield CLI runs the same breaking-change and can-i-deploy checks in your pipeline (GitHub Action, exit codes). Same job, two entry points: this server for AI agents, the CLI for CI/CD.

Tools

#	Tool	What it answers
1	`is_change_safe` ⭐	Is this change safe to merge/deploy? Will it break consumers? (`safeToMerge` + risk + blocking reasons)
2	`explain_breaking_changes`	What breaks, developer & consumer impact, suggested migration
3	`generate_migration_guide`	Migration guide (markdown) + safe rollout steps
4	`generate_release_notes`	Release notes for developer / customer / internal
5	`compare_specs`	The raw diff (breaking / additions / modifications / warnings) + risk score
6	`run_governance_review` 🔒	API governance ruleset beyond breaking changes (missing operationId, error responses, security scheme, pagination, versioning…) → located findings + suggested fixes. Paid (Team+)

Tools 1–5 accept specs inline (baseSpecContent / targetSpecContent) or by path (baseSpecPath / targetSpecPath). run_governance_review reviews a single spec (specContent / specPath).

🔒 run_governance_review is a paid feature — a FREE API key returns a payment_required error. Upgrade at specshield.io/pricing.

Full setup, verification & troubleshooting: [docs/mcp-server-setup.md](docs/mcp-server-setup.md).

Install

Requires Node.js ≥ 20 and a SpecShield API key (from specshield.io/account).

npx -y specshield-mcp-server

Claude Desktop

claude_desktop_config.json:

"mcpServers": { "specshield": { "command": "npx", "args": ["-y", "specshield-mcp-server"], "env": { "SPECSHIELD_API_KEY": "ss_your_key_here" } } } }

Claude Code

claude mcp add specshield --env SPECSHIELD_API_KEY=ss_your_key_here -- npx -y specshield-mcp-server

Cursor

~/.cursor/mcp.json (or the project .cursor/mcp.json):

"mcpServers": { "specshield": { "command": "npx", "args": ["-y", "specshield-mcp-server"], "env": { "SPECSHIELD_API_KEY": "ss_your_key_here" } } } }

Configuration

Env var	Required	Default	Purpose
`SPECSHIELD_API_KEY`	yes	—	Your SpecShield API key. Store it as a secret; never commit it.
`SPECSHIELD_API_URL`	no	`https://api.specshield.io`	Backend base URL (override for self-hosted/staging).
`SPECSHIELD_TIMEOUT_MS`	no	`30000`	Per-request timeout.
`SPECSHIELD_LOG_LEVEL`	no	`info`	`debug` \	`info` \	`warn` \	`error` (logs go to stderr).

Example prompts (lead with the deploy gate)

*"Here are my old and new openapi.yaml — is it safe to ship this API change to my consumers?"*
*"Compare v1.yaml and v2.yaml and tell me if I can deploy, and why not."*
*"Explain the breaking changes between these two specs and how consumers should migrate."*
*"Generate customer-facing release notes for this API change."*

Security & privacy

API key required. Sent only as the X-Api-Key header to your configured backend.
Read-only / analyze-only. No mutation tools, no shell execution, no arbitrary file access (a spec file is read only when you explicitly pass a path).
No secret or spec logging. The server never logs spec content, API keys, or request bodies; error messages are redacted and machine-readable.
Specs are sent to your configured SpecShield backend for analysis.

Local development

npm install

npm run build # tsc → dist/ npm test # vitest (no network) npm run lint npm run smoke # boots the server against a stubbed backend and lists tools npm start # run the built server over stdio

Specshield MCP Server

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Entwicklertoolsi

Häufige Fragen

Alternativen

GitHub

Desktop Commander

Cloudflare MCP

README vom Entwickler

SpecShield MCP Server

Tools

Install

Claude Desktop

Claude Code

Cursor

Configuration

Example prompts (lead with the deploy gate)

Security & privacy

Local development

License