Karea

karea-mcp

O servidor MCP para Karea. 12 ferramentas para que Claude Code, Cursor e qualquer outro cliente compatível com MCP possam criar, editar, fechar, resumir, vincular e gerenciar suas tarefas enquanto você codifica.

O que você pode fazer com ele

• Criar / editar / fechar / excluir tarefas e subtarefas de dentro do Claude Code enquanto ele codifica
• Ler e escrever markdown de formato longo em qualquer tarefa (perfeito para design de solução + notas de investigação)
• Acompanhar perguntas em aberto por tarefa e respondê-las depois
• Anexar recursos (referências de arquivos, links) às tarefas
• Vincular tarefas ao Jira e vice-versa
• Obter um resumo de produtividade em um intervalo de datas
• Gerenciar categorias, projetos e compartilhamento de projetos

Instalação

npx karea-mcp

Configuração (Claude Code)

Adicione ao ~/.claude.json (ou execute claude mcp add):

{
  "mcpServers": {
    "karea": {
      "command": "npx",
      "args": ["-y", "karea-mcp"],
      "env": {
        "KAREA_API_KEY": "your_key_here",
        "KAREA_URL": "https://karea.app"
      }
    }
  }
}

Obtenha sua chave de API em https://karea.app/dashboard/settings?section=api-keys.

Configuração (Cursor)

Adicione ao .cursor/mcp.json no seu projeto, ou ao ~/.cursor/mcp.json globalmente:

{
  "mcpServers": {
    "karea": {
      "command": "npx",
      "args": ["-y", "karea-mcp"],
      "env": {
        "KAREA_API_KEY": "your_key_here"
      }
    }
  }
}

Catálogo de ferramentas

12 ferramentas cobrindo 69 ações (regenerado por scripts/sync-metadata.mjs).

Cada ferramenta recebe um objeto action e um objeto params. Defina KAREA_MCP_LEGACY_TOOLS=1 para voltar a registrar todas as 69 ações como ferramentas individuais.

• karea_projects - Projetos e suas categorias: listar, criar, excluir, compartilhar e gerenciar as categorias dentro de um projeto.
  • karea_list_projects, karea_create_project, karea_delete_project, karea_share_project, karea_create_category, karea_delete_category
• karea_tasks - Tarefas: encontre-as, leia-as, crie-as, altere-as, feche-as. O principal ponto de entrada - comece aqui.
  • karea_list_tasks, karea_view_task, karea_view_tasks, karea_create_task, karea_edit_task, karea_edit_tasks, karea_close_task, karea_delete_task, karea_quick_task, karea_doing, karea_done
• karea_subtasks - Subtarefas e requisitos de fechamento - a lista de verificação que uma tarefa deve satisfazer antes de ser fechada.
  • karea_create_subtask, karea_list_subtasks, karea_add_requisite, karea_toggle_requisite, karea_delete_requisite
• karea_notes - Notas em uma tarefa - atualizações legíveis por humanos que o usuário lê - além do quadro de rascunhos com notas adesivas. Para memória privada entre sessões, use karea_docs (set_context).
  • karea_list_notes, karea_add_note, karea_edit_note, karea_delete_note, karea_list_sticky_notes, karea_create_sticky_note, karea_edit_sticky_note, karea_delete_sticky_note
• karea_docs - O documento markdown de formato longo de uma tarefa e seu Contexto de IA (memória de trabalho privada que sobrevive entre sessões).
  • karea_get_markdown, karea_set_markdown, karea_get_context, karea_set_context
• karea_questions - Perguntas em aberto: coisas que você está aguardando resposta. Crie, responda, edite, exclua.
  • karea_list_questions, karea_create_question, karea_answer_question, karea_edit_question, karea_delete_question
• karea_resources - A biblioteca de arquivos/documentos: listar, ler, criar, atualizar, enviar, excluir e anexar recursos às tarefas.
  • karea_list_resources, karea_get_resource, karea_create_resource, karea_update_resource, karea_upload_resource, karea_delete_resource, karea_link_resource_to_task, karea_unlink_resource_from_task
• karea_meetings - Reuniões, e as tarefas e perguntas em aberto anexadas a elas.
  • karea_list_meetings, karea_view_meeting, karea_create_meeting, karea_edit_meeting, karea_delete_meeting, karea_link_task_to_meeting, karea_unlink_task_from_meeting, karea_link_question_to_meeting, karea_unlink_question_from_meeting
• karea_reminders - Lembretes: veja o que está vencido, crie um, adie, dispense, marque como concluído.
  • karea_check_reminders, karea_create_reminder, karea_snooze_reminder, karea_dismiss_reminder, karea_mark_reminder_done
• karea_integrations - Links do JIRA em uma tarefa, e sessões de CLI de IA vinculadas a uma tarefa.
  • karea_get_jira_link, karea_link_jira, karea_unlink_jira, karea_link_session, karea_list_sessions, karea_unlink_session
• karea_assistant - Pergunte ao Karea uma pergunta em linguagem natural sobre seu trabalho, ou gere um resumo de um período.
  • karea_ask, karea_recap
• karea_help - esquema completo de parâmetros para qualquer ação.

Exemplo de fluxo de trabalho

You: I'm starting on the auth bug.
Claude (via karea-mcp): karea_doing("auth bug")
        --> status set to in_progress
You: Add a closing requisite: must pass the failing test.
Claude: karea_add_requisite(...)
You (later): I fixed it.
Claude: karea_toggle_requisite(...) then karea_done("auth bug")

Licença

MIT. Veja LICENSE.