Avvio rapido
Questo esempio collega KPainter MCP su uno studio locale e crea un primo risultato.
1 – Preparare una chiave di API
- Iscriviti a KPainter.
- Aprire il Pagina chiave API.
- Attivare e copiare la chiave.
- Conservato nella configurazione sicura del cliente MCP.
2 – Configurare lo studio
Quando è installato il cp-mcp:
{ "mcpServers": { "kpainter": { "command": "kp-mcp", "args": ["--stdio"], "env": { "KGP_API_KEY": "<your_api_key>" } } }}
Dall'indirizzo fonte del servizio KGP:
{ "mcpServers": { "kpainter": { "command": "python", "args": ["-m", "src.mcp_server", "--stdio"], "cwd": "/path/to/kgp-service", "env": { "KGP_API_KEY": "<your_api_key>" } } }}
3 - Le capacità di lettura
Chiamate le capacità prima. conferma che:
- Il conto è disponibile
- I prodotti includono il risultato desiderato
- file, video, immagine o app impostazioni provengono da questa risposta
4 – Creare un primo risultato
Chiamare kp_create:
{ "type": "video", "prompt": "Explain the customer escalation process to new employees", "max_credits": 300, "video": { "duration_seconds": 120, "aspect_ratio": "16:9", "language": "en" }}
Per i file sorgente, chiamare kp_upload_file prima e mettere ogni file_id restituito in input_file_ids.
5 - Poll e le uscite di lettura
- Chiamare kp_get periodicamente.
- Continua a aspettare durante la pianificazione o la produzione.
- Chiamare kp_outputs dopo la preparazione.
- Quando si è interrotti, controllare le azioni disponibili invece di creare un duplicato.
- Quando fallisce, mostrare una ragione chiara e un utile passo successivo.
6 – Rifinare un video
Passare questa forma a kp_message:
{ "creation_id": "creation_xxx", "content": "Keep everything else and make the second scene easier to understand", "idempotency_key": "video-edit-20260901-001"}
Continua a fare la stessa ricerca con kp_get.
