MCP local pentru Claude Code
konsolity mcp pornește un server MCP local pe intrarea și ieșirea standard (stdio). Un agent Claude care rulează pe aceeași mașină, de exemplu Claude Code, îl folosește pentru a vă lista gazdele și a rula comenzi pe ele, cu exact aceleași reguli ca konsolity run. Nimic nu trece prin conectorul Claude la distanță: agentul comunică direct cu CLI.
Mașina trebuie activată cu domeniul mcp (și hosts, snippets pentru instrumentele corespunzătoare).
Conectarea Claude Code
claude mcp add konsolity -- konsolity mcp
Verificați că serverul este detectat:
claude mcp list
Claude Code pornește konsolity mcp pentru fiecare sesiune și îl oprește la final. Fiecare sesiune MCP deschisă apare în lista sesiunilor CLI ale contului și poate fi încheiată de acolo.
Instrumente
| Instrument | Domeniu | Rol |
|---|---|---|
list_hosts |
hosts |
Gazdele din domeniu: identificator, etichetă, adresă, utilizator, grup. Niciun secret. |
list_snippets |
snippets |
Fragmentele din domeniu: identificator, nume, grup. |
run_command |
hosts, acces complet |
Rulează o comandă pe o gazdă din domeniu, conform regulilor de comenzi. |
run_snippet |
snippets + hosts, acces complet |
Rulează un fragment pe o gazdă din domeniu. |
list_sessions |
sessions |
Sesiunile CLI în curs pe cont. |
Cu acces doar în citire, sunt oferite doar instrumentele de listare.
Aceleași reguli
- Gazdă din afara domeniului, comandă care nu corespunde niciunei reguli: refuz, cu un mesaj clar pentru agent și o linie în jurnal.
- Comandă distructivă: confirmare în aplicație sau în consolă înainte de orice rulare, chiar și cu „Orice comandă”.
- Timp de execuție: limitat de timpul maxim al mașinii (60 s implicit, 1 h cel mult).
- Revocare sau încheiere a sesiunii: comanda în curs este oprită în mai puțin de 5 secunde, iar serverul MCP se oprește.
Ieșire limitată
Rezultatul unui instrument returnează codul de ieșire, durata, precum și ieșirea standard și ieșirea de erori, limitate la 64 KiB fiecare. Peste această limită, ieșirea este trunchiată, iar rezultatul o semnalează. Pentru ieșirea completă, folosiți konsolity run într-un terminal, a cărui ieșire nu este limitată.
Trei moduri de a conecta Claude
konsolity mcp |
Conectorul Claude | konsolity serve |
|
|---|---|---|---|
| Claude folosit | Claude Code (sau un agent) pe aceeași mașină | claude.ai, aplicația Claude | claude.ai, aplicația Claude |
| Transport | stdio local | https://mcp.konsolity.com/mcp |
coada conectorului, preluată de mașină |
| Cine execută | CLI de pe această mașină | aplicația desktop deschisă | CLI ca serviciu, fără interfață |
| Aprobare | domeniul și regulile mașinii | „Permite o dată” în aplicație | domeniul și regulile mașinii |
| Documentație | această pagină | Conectorul Claude | Serviciu și stocare |
În toate cazurile, comenzile distructive provenite de la o mașină CLI așteaptă confirmarea dumneavoastră.