KPainter

Use o servidor MCP remoto do KPainter para criar vídeos, slides e conteúdo interativo de conhecimento com base nas suas próprias fontes.

Ver em kpainter.aiExperimente este MCPPatrocinado

Documentação

Início Rápido

Esta página mostra a configuração mínima de MCP que coloca o KPainter em funcionamento dentro de um cliente compatível com MCP.

Passo 1: Obtenha uma Chave de API

O KPainter MCP usa a chave de API do próprio usuário.

Antes de configurar qualquer cliente:

  1. cadastre-se ou faça login no KPainter
  2. abra a página de Chave de API
  3. ative e copie sua chave de API
  4. mantenha-a pronta para a configuração do cliente MCP

Passo 2: Adicione um Servidor MCP Local via stdio

Para clientes MCP locais, stdio é o caminho mais fácil.

Se kp-mcp já estiver disponível no seu ambiente, uma configuração padrão fica assim:

Copie

{  "mcpServers": {    "kpainter": {      "command": "kp-mcp",      "env": {        "KGP_API_KEY": "<your_api_key>"      }    }  }}

Se você estiver executando a partir da árvore de código-fonte kgp-service, use:

Copie

{  "mcpServers": {    "kpainter": {      "command": "python",      "args": ["-m", "src.mcp_server"],      "cwd": "/path/to/kgp-service",      "env": {        "KGP_API_KEY": "<your_api_key>"      }    }  }}

Passo 3: Valide a Chave Primeiro

O binário da CLI é kp-mcp.

Os nomes das ferramentas MCP agora usam o prefixo kp_*, então comece com ferramentas como kp_me e kp_get_catalog.

Assim que o servidor MCP estiver conectado, comece com:

  • kp_me

Use-o para confirmar:

  • a chave é válida
  • ela pertence ao usuário pretendido
  • ela pode gerenciar criações

Não pule esta etapa e vá direto para a criação.

Passo 4: Leia o Catálogo

Chame:

  • kp_get_catalog

Use-o antes de escolher:

  • type
  • aspect_ratio
  • output_quality
  • voice_id
  • style_id
  • duration_seconds
  • scene_count
  • image_provider / image_model / image_quality
  • video_model / video_task / video_resolution / video_duration_seconds

Não adivinhe esses valores.

Passo 5: Crie o Primeiro Resultado

Um primeiro fluxo de trabalho de caminho feliz geralmente se parece com isto:

  1. kp_me
  2. kp_get_catalog
  3. kp_create_creation
  4. kp_get_job_status
  5. kp_get_creation

Por exemplo, você pode pedir ao seu cliente MCP para criar algo como:

Crie um Vídeo de Leitura em Voz Alta em inglês que explique como o MCP funciona em 6 páginas.

O cliente deve então mapear essa solicitação para o tipo oficial e os parâmetros retornados por kp_get_catalog.

As páginas de produto do MCP mostram os argumentos planos exatos aceitos por kp_create_creation. Não copie as formas aninhadas de image_generation ou video_generation do REST OpenAPI para uma chamada de ferramenta MCP.

Passo 6: Leia o Detalhe Final

Quando o trabalho for concluído, leia:

  • main_url
  • artifacts
  • scenes
  • editable_actions

de kp_get_creation.

Este é o principal local para ler o resultado finalizado.

Se Você Precisar de Edição em Nível de Cena

Para tipos suportados, inspecione editable_actions e scenes primeiro, depois use:

  • kp_edit_creation

As ações atuais de edição de cena são:

  • update_scene_narration
  • regenerate_scene

Trate as edições também como assíncronas:

  1. kp_edit_creation
  2. kp_get_job_status
  3. kp_get_creation

Leia a Seguir

  • Authentication
    entenda como api_key e o fallback de chave padrão funcionam
  • Transport Modes
    veja quando usar stdio ou Streamable HTTP
  • Available Tools
    navegue pelas ferramentas, recursos e prompts atuais