@lionchat/mcp-server 0.5.20 → 0.5.21

package/dist/docs/instructions.md

@@ -171,6 +171,17 @@ lionchat_conversations_messages_list (conversation_id: 123)
 3. lionchat_inboxes_public_conversations_create (vincula contato à inbox)
 ```
 
+### Criar funil (kanban) novo com etapas
+
+**FUNIL = KANBAN = pipeline = board — são a MESMA coisa no LionChat.** Quando o usuário pedir "cria um kanban", "monta um pipeline" ou "cria um funil", a ferramenta é `lionchat_funnels_create` (não existe endpoint separado de "criar kanban").
+
+```
+1. lionchat_funnels_create (funnel.name + funnel.stages)
+   funnel.stages = objeto com uma chave (slug) por etapa:
+   { "novo_lead": { "name": "Novo Lead", "color": "#3B82F6", "position": 1 } }
+2. lionchat_funnels_show (conferir o resultado)
+```
+
 ### Criar card Kanban a partir de uma conversa
 
 Use `lionchat_kanban_items_create`. NÃO existem campos `contact_id`/`conversation_id`/`stage` — o contato vem pela conversa vinculada (`conversation_display_id`) e a etapa é o slug em `funnel_stage`.
@@ -189,7 +200,7 @@ POST /api/v1/accounts/{account_id}/kanban_items
 ```
 
 - `conversation_display_id` é **opcional** (card sem conversa vinculada é válido).
-- Ignore as ferramentas `lionchat_kanban_v2_*` — apontam para controllers inexistentes.
+- As ferramentas `lionchat_kanban_v2_*` cobrem anexos de card/nota e automações do Kanban (controllers criados em 07/2026 — a orientação antiga de ignorá-las está obsoleta). Upload de anexo via MCP segue sem suporte (limitação de file upload).
 
 ### Relatório de produtividade
 ```

package/dist/docs/resources/glossary.md

@@ -198,8 +198,10 @@ os de `user_ids` viram membros comuns. A resposta traz `is_supervisor` (boolean)
 
 ## Funnel (Funil do Kanban)
 
+**Funil, Kanban, pipeline e board são sinônimos no LionChat** — o usuário pode usar qualquer um desses nomes; a entidade é sempre o Funnel (`lionchat_funnels_*`).
+
 - `name`: nome do funil
-- `stages`: array de etapas — cada uma com `name`, `color`, `position`
+- `stages`: objeto de etapas — uma chave (slug) por etapa, cada uma com `name`, `color`, `position`
 - `archived`: `true` = não aparece na UI principal
 
 ## Captain::Assistant (AI Agente / IA de atendimento)

package/endpoints.json

@@ -2247,8 +2247,8 @@
     "id": "lionchat_funnels_list",
     "method": "GET",
     "path": "/api/v1/accounts/{account_id}/funnels",
-    "title": "Listar Funis",
-    "description": "Lista todos os funis com contagem de itens por etapa (cache 5min). NAO e paginado. ACESSO (2026-06): retorna SO os funis visiveis pro usuario do token (admin, permissao kanban, funil aberto ou participante). Funil nao-visivel da 404 no show.",
+    "title": "Listar Funis (Kanbans)",
+    "description": "FUNIL = KANBAN (pipeline/board) — no LionChat sao a mesma coisa. Lista todos os funis com contagem de itens por etapa (cache 5min). NAO e paginado. ACESSO (2026-06): retorna SO os funis visiveis pro usuario do token (admin, permissao kanban, funil aberto ou participante). Funil nao-visivel da 404 no show.",
     "category": "Funis",
     "params": [],
     "returns": "array de funis (cada um com stage_items_count); sem meta/paginacao",
@@ -2265,8 +2265,8 @@
     "id": "lionchat_funnels_create",
     "method": "POST",
     "path": "/api/v1/accounts/{account_id}/funnels",
-    "title": "Criar Funil",
-    "description": "Cria um novo funil (limite de 2 no plano free). Cria novo funil. Obrigatórios: funnel.name. Valida unicidade quando aplicável. Retorna o funil criado com ID atribuído.",
+    "title": "Criar Funil (Kanban)",
+    "description": "FUNIL = KANBAN (pipeline/board) — no LionChat sao a mesma coisa; pra \"criar um kanban\" use ESTA ferramenta. Cria um funil novo JA COM AS ETAPAS via funnel.stages. Obrigatorios: funnel.name. Limite de 2 funis no plano free. Retorna o funil criado com ID atribuido.",
     "category": "Funis",
     "params": [
       {
@@ -2295,7 +2295,7 @@
         "type": "object",
         "location": "body",
         "required": false,
-        "description": "Estagios"
+        "description": "Etapas do kanban. Objeto com uma chave (slug) por etapa: {\"novo_lead\": {\"name\": \"Novo Lead\", \"color\": \"#3B82F6\", \"position\": 1, \"description\": \"opcional\"}}. position define a ordem das colunas."
       },
       {
         "name": "funnel.settings",
@@ -2316,7 +2316,9 @@
     "common_use_cases": [
       "Cadastro inicial de funil",
       "Automação a partir de evento externo",
-      "Importação manual via API"
+      "Importação manual via API",
+      "Criar um kanban novo com etapas",
+      "Montar pipeline/board comercial"
     ],
     "related_tools": [
       "lionchat_funnels_create_1",
@@ -2327,8 +2329,8 @@
     "id": "lionchat_funnels_show",
     "method": "GET",
     "path": "/api/v1/accounts/{account_id}/funnels/{id}",
-    "title": "Detalhe do Funil",
-    "description": "Retorna detalhes de um funil. Retorna detalhes completos de UM funil específico pelo ID. Inclui campos relacionais quando aplicável.",
+    "title": "Detalhe do Funil (Kanban)",
+    "description": "FUNIL = KANBAN (pipeline/board) — no LionChat sao a mesma coisa. Retorna detalhes de um funil. Retorna detalhes completos de UM funil específico pelo ID. Inclui campos relacionais quando aplicável.",
     "category": "Funis",
     "params": [
       {
@@ -2351,8 +2353,8 @@
     "id": "lionchat_funnels_update",
     "method": "PATCH",
     "path": "/api/v1/accounts/{account_id}/funnels/{id}",
-    "title": "Atualizar Funil",
-    "description": "Atualiza funil. Atualiza campos do funil existente. Suporta atualização parcial (PATCH) — só campos enviados são alterados. Campos suportados: funnel.name, funnel.stages, funnel.settings.",
+    "title": "Atualizar Funil (Kanban)",
+    "description": "FUNIL = KANBAN (pipeline/board) — no LionChat sao a mesma coisa. Atualiza funil. Atualiza campos do funil existente. Suporta atualização parcial (PATCH) — só campos enviados são alterados. Campos suportados: funnel.name, funnel.stages, funnel.settings.",
     "category": "Funis",
     "params": [
       {
@@ -2374,7 +2376,7 @@
         "type": "object",
         "location": "body",
         "required": false,
-        "description": "Estagios"
+        "description": "Etapas do kanban. Objeto com uma chave (slug) por etapa: {\"novo_lead\": {\"name\": \"Novo Lead\", \"color\": \"#3B82F6\", \"position\": 1, \"description\": \"opcional\"}}. position define a ordem das colunas."
       },
       {
         "name": "funnel.settings",
@@ -2396,8 +2398,8 @@
     "id": "lionchat_funnels_destroy",
     "method": "DELETE",
     "path": "/api/v1/accounts/{account_id}/funnels/{id}",
-    "title": "Excluir Funil",
-    "description": "Exclui funil (deve estar vazio). Remove funil permanentemente. CUIDADO: ação irreversível em muitos casos. Verifique dependências antes.",
+    "title": "Excluir Funil (Kanban)",
+    "description": "Funil = kanban. Exclui funil (deve estar vazio). Remove funil permanentemente. CUIDADO: ação irreversível em muitos casos. Verifique dependências antes.",
     "category": "Funis",
     "params": [
       {
@@ -2420,8 +2422,8 @@
     "id": "lionchat_funnels_list_1",
     "method": "GET",
     "path": "/api/v1/accounts/{account_id}/funnels/{id}/stage_stats",
-    "title": "Stats por Etapa",
-    "description": "Estatisticas agregadas por etapa do funil.",
+    "title": "Stats por Etapa do Funil (Kanban)",
+    "description": "Funil = kanban. Estatisticas agregadas por etapa do funil.",
     "category": "Funis",
     "params": [
       {
@@ -2489,8 +2491,8 @@
     "id": "lionchat_funnels_create_1",
     "method": "POST",
     "path": "/api/v1/accounts/{account_id}/funnels/{id}/reassign_agent",
-    "title": "Reatribuir Agente",
-    "description": "Reatribui agentes dos cards do funil em massa.",
+    "title": "Reatribuir Agente dos Cards do Funil (Kanban)",
+    "description": "Funil = kanban. Reatribui agentes dos cards do funil em massa.",
     "category": "Funis",
     "params": [
       {
@@ -2530,8 +2532,8 @@
     "id": "lionchat_funnels_create_2",
     "method": "POST",
     "path": "/api/v1/accounts/{account_id}/funnels/{id}/migrate_stage",
-    "title": "Transferir Cards Entre Etapas",
-    "description": "Transfere os cards de uma etapa para outra.",
+    "title": "Transferir Cards Entre Etapas do Funil (Kanban)",
+    "description": "Funil = kanban. Transfere os cards de uma etapa para outra.",
     "category": "Funis",
     "params": [
       {
@@ -2578,8 +2580,8 @@
     "id": "lionchat_funnels_archive",
     "method": "PATCH",
     "path": "/api/v1/accounts/{account_id}/funnels/{id}/archive",
-    "title": "Arquivar Funil",
-    "description": "Arquiva um funil. Atualiza campos do funil existente. Suporta atualização parcial (PATCH) — só campos enviados são alterados.",
+    "title": "Arquivar Funil (Kanban)",
+    "description": "Funil = kanban. Arquiva um funil. Atualiza campos do funil existente. Suporta atualização parcial (PATCH) — só campos enviados são alterados.",
     "category": "Funis",
     "params": [
       {
@@ -2602,8 +2604,8 @@
     "id": "lionchat_funnels_unarchive",
     "method": "PATCH",
     "path": "/api/v1/accounts/{account_id}/funnels/{id}/unarchive",
-    "title": "Desarquivar Funil",
-    "description": "Desarquiva um funil. Atualiza campos do funil existente. Suporta atualização parcial (PATCH) — só campos enviados são alterados.",
+    "title": "Desarquivar Funil (Kanban)",
+    "description": "Funil = kanban. Desarquiva um funil. Atualiza campos do funil existente. Suporta atualização parcial (PATCH) — só campos enviados são alterados.",
     "category": "Funis",
     "params": [
       {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lionchat/mcp-server",
-  "version": "0.5.20",
+  "version": "0.5.21",
   "description": "MCP server for LionChat API — 547 tools + 10 resources + 9 prompts. Audit-log aware, completion API, progress notifications.",
   "type": "module",
   "main": "dist/index.js",