MCP Server

Em breve — MVP3

O MCP Server está planejado para o MVP3. Esta página documenta o design.

O CloudTasks MCP Server implementa o Model Context Protocol — o protocolo aberto criado pela Anthropic para integrar ferramentas externas com modelos de linguagem como Claude.

O que é MCP

O MCP permite que um agente de IA (como Claude) use ferramentas externas de forma estruturada. Em vez de chamar APIs REST manualmente, o agente simplesmente chama uma "tool" e o MCP Server cuida da comunicação com o CloudTasks.

Ferramentas planejadas (13)

Issues

Tool	Descrição
create_issue	Criar uma issue com título, descrição, tipo, prioridade e responsável
get_issue	Buscar issue por chave (ex: FE-7)
update_issue	Atualizar campos de uma issue
list_issues	Listar issues com filtros (status, prioridade, responsável)
delete_issue	Deletar uma issue

Projetos

Tool	Descrição
list_projects	Listar projetos do workspace
get_project	Detalhes de um projeto incluindo status
create_project	Criar novo projeto

Busca

Tool	Descrição
search_issues	Busca híbrida semântica sobre issues

Workspaces e Organizações

Tool	Descrição
get_workspace	Detalhes do workspace atual
list_members	Membros do workspace

Utilitários

Tool	Descrição
get_my_issues	Issues atribuídas ao usuário autenticado
get_stats	Estatísticas do workspace (issues por status, prioridade)

Como conectar com Claude

Após o lançamento do MVP3, você poderá adicionar o CloudTasks como MCP Server no Claude Desktop:

~/.claude/claude_desktop_config.json

{
  "mcpServers": {
    "cloudtasks": {
      "command": "cloudtasks-mcp",
      "args": [],
      "env": {
        "CLOUDTASKS_URL": "https://tasks.cloudface.tech",
        "CLOUDTASKS_TOKEN": "seu-access-token",
        "CLOUDTASKS_WORKSPACE": "meu-workspace"
      }
    }
  }
}

Ou via npx sem instalação:

{
  "mcpServers": {
    "cloudtasks": {
      "command": "npx",
      "args": ["-y", "@cloudface/cloudtasks-mcp"],
      "env": {
        "CLOUDTASKS_URL": "https://tasks.cloudface.tech",
        "CLOUDTASKS_TOKEN": "seu-access-token",
        "CLOUDTASKS_WORKSPACE": "meu-workspace"
      }
    }
  }
}

Exemplo de uso com Claude

Com o MCP configurado, você pode pedir ao Claude:

"Crie uma issue de bug no projeto FE com alta prioridade para o Gabriel: OAuth callback falhando no iOS 17"

"Quais issues estão Em progresso no workspace produto?"

"Busca semântica: encontre issues relacionadas a lentidão no carregamento da lista"

O MCP Server traduz essas intenções em chamadas à API REST do CloudTasks e retorna os resultados formatados para o Claude.