Krutrim Cloud MCP Server

Nutzen Sie Krutrim Cloud von Cursor, Claude Desktop, Claude Code oder Codex aus. Der MCP-Server bietet Discovery und kontrollierte Operationen für VPCs, Compute, Storage, Netzwerk, Kubernetes, KPods und IAM.

Installation

Empfohlen: uvx

Führen Sie das veröffentlichte stdio-Paket direkt von PyPI aus, ohne es in Ihrer aktuellen Python-Umgebung zu installieren:

uvx krutrim-mcp-server --version

Python-Virtualenv

Sie können das Paket auch mit standardmäßigen Python-Werkzeugen installieren und ausführen:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install krutrim-mcp-server==1.0.0
python -m krutrim_mcp_server --version

Aktivieren Sie unter Windows die Umgebung mit .venv\Scripts\activate.

Die aktuelle stabile Version ist 1.0.0. Verwenden Sie uvx krutrim-mcp-server@1.0.0 --version, wenn Sie genau diese Version festlegen möchten. Zukünftige Versionen folgen Semantic Versioning: Fehlerbehebungen erhöhen die Patch-Version, abwärtskompatible Funktionen erhöhen die Minor-Version und Breaking Changes erhöhen die Major-Version.

Related MCP server: CipherTrust Manager MCP Server

Lokal verbinden

Anmelden und MFA abschließen

Melden Sie sich als Root-Benutzer an, um das Paar aus Access-Token und Refresh-Token zu erhalten:

curl --location \
  'https://cloud.olakrutrim.com/iam/v1/signInAsRootUser' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{"email":"YOUR_EMAIL","password":"YOUR_PASSWORD"}'

Für einen IAM-Benutzer verwenden Sie die Konto-ID mit demselben Ablauf:

curl --location \
  'https://cloud.olakrutrim.com/iam/v1/signInAsIAMUser' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{"accountId":"YOUR_ACCOUNT_ID","email":"YOUR_EMAIL","password":"YOUR_PASSWORD"}'

Bewahren Sie das zurückgegebene Token-Paar vertraulich auf. Wenn MFA aktiviert ist, verifizieren Sie die MFA mit dem zurückgegebenen Access-Token, bevor Sie den MCP-Client konfigurieren. Setzen Sie die zurückgegebenen Werte für KRUTRIM_ACCESS_TOKEN und KRUTRIM_REFRESH_TOKEN über einen sicheren Secret-Manager oder eine geschützte Umgebung; platzieren Sie sie nicht im Shell-Verlauf.

curl --location \
  'https://cloud.olakrutrim.com/iam/v1/mfa/verify' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --data '{"otp":"YOUR_MFA_OTP"}'

Die MFA-Verifizierung verwendet dasselbe Access-Token; sie rotiert das Token-Paar nicht. Führen Sie beide Befehle nur von einem vertrauenswürdigen Host aus und bewahren Sie Zugangsdaten, OTPs, Antworten, Transkripte und Protokolle vertraulich auf.

Sie benötigen ein IAM-Access-Token und ein Refresh-Token aus derselben Anmeldesitzung. Setzen Sie beide in der MCP-Client-Konfiguration; legen Sie Token-Werte nicht in der Versionsverwaltung ab.

{
  "mcpServers": {
    "krutrim-cloud": {
      "command": "uvx",
      "args": ["krutrim-mcp-server"],
      "env": {
        "KRUTRIM_ACCESS_TOKEN": "YOUR_IAM_ACCESS_TOKEN",
        "KRUTRIM_REFRESH_TOKEN": "YOUR_IAM_REFRESH_TOKEN"
      }
    }
  }
}

Für eine Installation im Python-Virtualenv behalten Sie dieselben env-Werte bei und ersetzen Sie command und args durch den absoluten Python-Pfad des Virtualenv:

{
  "command": "/absolute/path/to/.venv/bin/python",
  "args": ["-m", "krutrim_mcp_server"]
}

Verwenden Sie unter Windows den absoluten Pfad zu .venv\Scripts\python.exe.

Starten Sie den Client nach einer Änderung seiner Konfiguration neu. Der Server aktualisiert das Access-Token, solange das Refresh-Token gültig bleibt. Wenn die Aktualisierung abgelehnt wird, melden Sie sich erneut an und ersetzen Sie beide Werte.

Für Codex fügen Sie dies zu ~/.codex/config.toml hinzu:

[mcp_servers.krutrim-cloud]
enabled = true
command = "uvx"
args = ["krutrim-mcp-server"]

[mcp_servers.krutrim-cloud.env]
KRUTRIM_ACCESS_TOKEN = "YOUR_IAM_ACCESS_TOKEN"
KRUTRIM_REFRESH_TOKEN = "YOUR_IAM_REFRESH_TOKEN"

Für ein Python-Virtualenv setzen Sie command auf den absoluten Python-Pfad und setzen Sie stattdessen args = ["-m", "krutrim_mcp_server"].

Die Tools verwenden

Beginnen Sie mit einer Leseoperation, wählen Sie die zurückgegebenen Identifikatoren und Regionen exakt aus und bestätigen Sie dann Mutationen. Beispiele:

List my VPCs in In-Bangalore-1.
List IAM users.
Create a VPC in In-Hyderabad-1 with CIDR 10.20.0.0/24. Ask for confirmation first.

Mutierende Aufrufe erfordern confirm=true. Setzen Sie KRUTRIM_MCP_READ_ONLY=true, um alle Mutationen bei einer lokalen Installation zu blockieren.

Überprüfen

uvx krutrim-mcp-server --list-tools
uvx krutrim-mcp-server --doctor

--list-tools überprüft den installierten Katalog. --doctor überprüft die lokale Konfiguration; verwenden Sie ein schreibgeschütztes Cloud-Tool wie list_vpcs, um Ihre Berechtigungen zu überprüfen.

Benutzerhandbuch

Bevor Sie beginnen

Verwenden Sie ein IAM-Access-Token und ein Refresh-Token aus derselben Anmeldesitzung. Konfigurieren Sie sowohl KRUTRIM_ACCESS_TOKEN als auch KRUTRIM_REFRESH_TOKEN in Ihrem MCP-Client.

Übergeben Sie immer eine der unterstützten Regionen, wenn ein Tool dies erfordert:

• In-Bangalore-1

• In-Hyderabad-1

Empfohlener Workflow

1. Listen Sie Ressourcen auf, bevor Sie sie ändern.

2. Wählen Sie exakte Identifikatoren, die vom Listen-Aufruf zurückgegeben wurden.

3. Überprüfen Sie die angeforderte Änderung.

4. Verwenden Sie confirm=true erst nach der Überprüfung.

Verwenden Sie beispielsweise list_vpcs vor describe_vpc oder delete_vpc; verwenden Sie list_subnets vor der VM-Erstellung; verwenden Sie einen VM-Flavor aus der Liste, anstatt einen zu erraten.

Häufige Aufgaben

IAM-Operationen erfordern vollständige IAM-KRNs. Verwenden Sie die von einer Listen-Operation zurückgegebene KRN; verwenden Sie keine UUID, keinen Anzeigenamen und keinen Teil-Identifikator.

Sicherheitskontrollen

• Mutationen erfordern confirm=true.

• KRUTRIM_MCP_READ_ONLY=true blockiert jede Mutation.

• Wiederholen Sie eine Erstellung mit Zeitüberschreitung nicht sofort. Listen Sie zuerst nach Name oder Identifikator auf, um festzustellen, ob die Ressource erstellt wurde.

• Überprüfen Sie bei destruktiven Operationen den ausgewählten Identifikator, bevor Sie bestätigen.

• Das Passwort von create_iam_user ist sensibel. Verwenden Sie es nur von einem vertrauenswürdigen MCP-Host, da Tool-Aufruf-Transkripte und Host-Protokolle außerhalb der Kontrolle dieses Pakets liegen. Verwenden Sie den genehmigten Prozess zur verschlüsselten Zustellung von Zugangsdaten oder den Out-of-Band-Prozess, sofern zutreffend.

Fehlerbehebung

Für Object-Storage-Zugriffsschlüssel befolgen Sie Verschlüsselte Zustellung des Storage-Zugriffsschlüssels.

Verschlüsselte Zustellung des Storage-Zugriffsschlüssels

create_storage_access_key liefert ein Chiffrat-Bündel, kein Klartext-Geheimnis. Generieren Sie einen Empfängerschlüssel auf dem Gerät, das den Schlüssel verwenden wird:

krutrim-mcp-credentials init

Verwenden Sie den ausgegebenen public_key und fingerprint in der MCP-Anfrage. Bitten Sie den Client, Name, Region und Fingerprint anzuzeigen, bevor Sie die Erstellung bestätigen.

Nachdem das Tool ein Bündel zurückgegeben hat, entschlüsseln Sie es lokal:

krutrim-mcp-credentials decrypt \
  --bundle /path/to/storage-key.bundle.json \
  --output ~/.config/krutrim-mcp/storage-key.json

Bewahren Sie den privaten Schlüssel und die entschlüsselte Ausgabe auf Ihrem Gerät auf. Fügen Sie keines von beiden in einen MCP-Prompt, ein Repository, ein Ticket oder eine Chat-Nachricht ein. Wenn die Erstellung eine Zeitüberschreitung aufweist, listen Sie vorhandene Schlüssel auf, bevor Sie es erneut versuchen.