cdek-mcp
cdek-mcp
MCP-Server für die CDEK-Versand-API (v2). 16 Tools decken den gesamten Versandlebenszyklus ab: Tarifberechnung, Auftragsverwaltung, Sendungsverfolgung, Standortsuche, Kurierabholung, Barcode-/Belegerzeugung und Webhooks.
Tools (16)
Tarife
Tool | Beschreibung |
| Berechnet Versandkosten und -zeit für einen bestimmten Tarif |
| Ruft alle verfügbaren Tarife mit Preisen für eine Route ab |
Aufträge
Tool | Beschreibung |
| Erstellt einen Versandauftrag mit Absender, Empfänger und Paketen |
| Ruft Auftragsdetails und -status per UUID ab |
| Storniert/löscht einen Auftrag per UUID |
| Durchsucht/filtert Aufträge nach Datumsbereich, IM-Nummer oder CDEK-Frachtbrief |
Sendungsverfolgung
Tool | Beschreibung |
| Verfolgt Sendungen anhand der CDEK-Frachtbriefnummer |
Standorte
Tool | Beschreibung |
| Durchsucht das Städteverzeichnis nach Name, Postleitzahl oder Land |
| Durchsucht das Regionsverzeichnis nach Land oder Name |
| Findet Abholpunkte und Paketstationen anhand von Stadt oder GPS-Koordinaten |
Barcode & Druck
Tool | Beschreibung |
| Erzeugt Barcode/Etikett für einen Auftrag |
| Erzeugt Beleg-/Frachtbrief-PDF für einen Auftrag |
Kurierabholung
Tool | Beschreibung |
| Plant eine Kurierabholung für einen Auftrag ein |
| Prüft den Status der Kurierabholungsanfrage |
Webhooks
Tool | Beschreibung |
| Registriert Webhook für Auftragsstatus-Updates oder Lieferfotos |
| Entfernt ein Webhook-Abonnement per UUID |
Related MCP server: Parcel MCP Server
Schnellstart
Claude Desktop
~/.config/claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"cdek": {
"command": "npx",
"args": ["-y", "@theyahia/cdek-mcp"],
"env": {
"CDEK_CLIENT_ID": "<YOUR_CLIENT_ID>",
"CDEK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
"CDEK_SANDBOX": "true"
}
}
}
}Cursor / Windsurf
.cursor/mcp.json oder .windsurf/mcp.json:
{
"mcpServers": {
"cdek": {
"command": "npx",
"args": ["-y", "@theyahia/cdek-mcp"],
"env": {
"CDEK_CLIENT_ID": "<YOUR_CLIENT_ID>",
"CDEK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
"CDEK_SANDBOX": "true"
}
}
}
}VS Code (Copilot)
.vscode/mcp.json:
{
"servers": {
"cdek": {
"command": "npx",
"args": ["-y", "@theyahia/cdek-mcp"],
"env": {
"CDEK_CLIENT_ID": "<YOUR_CLIENT_ID>",
"CDEK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
"CDEK_SANDBOX": "true"
}
}
}
}Streamable HTTP Transport
Für Web-Bereitstellungen verwenden Sie das --http-Flag oder die Umgebungsvariable HTTP_PORT:
HTTP_PORT=3000 npx @theyahia/cdek-mcp --httpEndpunkte:
POST /mcp— MCP JSON-RPCGET /mcp— SSE-StreamDELETE /mcp— SitzungsbeendigungGET /health— Health-Check
Umgebungsvariablen
Variable | Erforderlich | Beschreibung |
| Ja | Client-ID aus dem CDEK-Dashboard |
| Ja | Client-Secret aus dem CDEK-Dashboard |
| Nein |
|
| Nein | Port für den HTTP-Transport (aktiviert den HTTP-Modus) |
Holen Sie sich Ihre API-Schlüssel: CDEK Dashboard > Integration > API-Schlüssel.
Sandbox-Modus
Setzen Sie CDEK_SANDBOX=true, um die CDEK-Testumgebung (api.edu.cdek.ru) zu verwenden. Die Produktion verwendet api.cdek.ru.
CDEK stellt ein gemeinsames Sandbox-Konto für Integrationstests bereit:
Client-ID:
EMscd6r9JnFiQ3bLoyjJY6eM78JrJceIClient-Secret:
PjLZkKBHEiLK3YsjtNrt3TGNG0ahs3kh
⚠️ CDEK rotiert dieses gemeinsame Testkonto von Zeit zu Zeit. Wenn Sie
OAuth token error (HTTP 401) … invalid_clienterhalten, wurde das öffentliche Paar rotiert — fordern Sie Ihre eigenen Sandbox-Schlüssel über das CDEK-Integrationsdashboard an (lk.cdek.ru → Integration → API-Schlüssel).
Authentifizierung
OAuth-2.0-Client-Credentials-Ablauf, übernommen von der OAuthStrategy in @theyahia/mcp-core:
Automatischer Token-Abruf bei der ersten Anfrage
Token-Caching mit proaktivem Refresh kurz vor Ablauf
Deduplizierung gleichzeitiger Anfragen (ein einzelner laufender Token-Refresh wird gemeinsam genutzt)
Automatischer Wiederholungsversuch bei 401 mit Token-Invalidierung
E-Commerce-Stack
Kombinieren Sie es mit anderen russian-mcp-Servern für einen vollständigen E-Commerce-KI-Stack:
Server | Zweck |
cdek-mcp | Versand & Logistik |
Adressvalidierung, Firmensuche |
Teil der russian-mcp-Serie.
Demo-Prompts
„Wie viel kostet es, ein 2-kg-Paket von Moskau nach Sankt Petersburg zu versenden?“ Verwendet
get_cities, um Stadtcodes zu finden, danncalculate_tariff_list, um alle verfügbaren Tarife zu vergleichen.„Finde den nächstgelegenen CDEK-Abholpunkt am Roten Platz“ Verwendet
get_cities, um den Moskauercity_codeaufzulösen, dannlist_delivery_pointsmitlatitude: 55.7539,longitude: 37.6208,radius_km: 5— die Ergebnisse werden auf den Radius gefiltert und nach Entfernung sortiert (jeweils mitкоординатыundрасстояние_кмversehen).„Erstelle einen Auftrag, um ein Buch von Kasan nach Nowosibirsk zu senden, plane die Kurierabholung und drucke den Beleg“ Verwendet
create_order, danncreate_courier_pickup, um die Abholung zu planen, undprint_receiptfür den Frachtbrief.
Entwicklung
git clone https://github.com/theYahia/cdek-mcp.git
cd cdek-mcp
npm install
npm run lint # ESLint (flat config)
npm run typecheck # tsc --noEmit
npm run build # emit dist/
npm test # unit tests (vitest)
npm run test:e2e # e2e smoke test (lists tools, no real credentials)Führen Sie den Server lokal gegen die CDEK-Sandbox (api.edu.cdek.ru) aus — verwenden Sie das gemeinsame Testpaar aus Sandbox-Modus oder Ihre eigenen Sandbox-Schlüssel:
CDEK_SANDBOX=true \
CDEK_CLIENT_ID=<YOUR_SANDBOX_CLIENT_ID> \
CDEK_CLIENT_SECRET=<YOUR_SANDBOX_CLIENT_SECRET> \
npm run devSiehe CHANGELOG.md für Versionshinweise.
Lizenz
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Furgonetka MCP Server is an extension for LLMs (such as Claude) that integrates AI assistants with Poland's most popular courier brokerage platform. The server enables models to interact directly with services from various couriers (including InPost, DPD, DHL, UPS, and Poczta Polska) through a single, unified interface. With this integration, your AI stops just "writing about logistics" and starts actually managing it.
Multi-carrier shipping for AI agents: compare rates, buy labels, track packages, validate addresses
Russian APIs for AI agents: YooKassa, CDEK, Bitrix24 and more. Ready scenarios with code. No key.
Manage Shipday orders, drivers, driver earnings, reports from your AI assistants.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables interaction with Shiprocket shipping services to check courier rates and delivery times, create and manage orders, ship packages, track shipments, and schedule pickups through natural language commands.29ISC
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to track and manage deliveries by interacting with the Parcel delivery tracking API. Users can add new shipments, retrieve active delivery statuses, and look up carrier information through natural language.2MIT
- AlicenseBqualityDmaintenanceIntegrates with CDEK delivery API to manage orders, track shipments, find pickup points, and handle delivery labels and barcodes through natural language.49MIT
- AlicenseNot gradedqualityDmaintenanceEnables courier rate checks, order management, shipping, and tracking via Shiprocket's API through natural language.ISC