BasicOps

Projetos, tarefas e comunicação construídos para IA

Documentação

BasicOps MCP Server

O servidor oficial do Model Context Protocol (MCP) para BasicOps — uma plataforma de gerenciamento de projetos para tarefas, notas e colaboração em equipe.

Conecte qualquer cliente de IA compatível com MCP (Claude, Cursor, Windsurf, etc.) ao seu workspace BasicOps e gerencie seu trabalho usando linguagem natural.

Endpoints

Transporte	URL
Streamable HTTP	`https://app.basicops.com/mcp`
SSE (legado)	`https://app.basicops.com/mcp/sse`

Autenticação

O servidor MCP do BasicOps suporta dois métodos de autenticação:

OAuth 2.1 (recomendado)

A maioria dos clientes MCP (Claude Desktop, Cursor, Windsurf, etc.) suporta OAuth 2.1. Ao conectar, você será redirecionado pelo fluxo de autorização OAuth 2.1 para conceder acesso ao seu workspace BasicOps. Nenhum gerenciamento manual de tokens é necessário.

API Key

Para clientes que não suportam a atualização de tokens OAuth (como Claude CLI / Claude Code), você pode autenticar usando uma API key do BasicOps.

No BasicOps, vá para Configurações → API Keys e gere uma nova chave. Copie a chave — ela é exibida apenas uma vez.
Configure seu cliente MCP para enviar a chave como um token Bearer no cabeçalho Authorization (veja as instruções específicas do cliente abaixo).

API keys não expiram por padrão, mas podem ser revogadas a qualquer momento em Configurações → API Keys.

Funcionalidades

O servidor MCP do BasicOps expõe ferramentas para trabalhar com todo o seu workspace BasicOps:

Projetos — criar, atualizar, listar e arquivar projetos
Tarefas e Subtarefas — criar, atualizar, atribuir, priorizar e concluir tarefas
Seções — organizar tarefas dentro de projetos usando seções
Notas — criar e gerenciar notas de projetos
Mensagens — postar e responder mensagens em projetos e tarefas
Modelos — listar e gerenciar modelos de projetos
Usuários — consultar membros da equipe e informações do usuário atual
Anexos de Arquivos — enviar e anexar arquivos a tarefas

Primeiros Passos

1. Configure seu cliente MCP

Claude Desktop

No Claude Desktop, adicione um novo conector MCP usando a opção de conector personalizado. Digite um nome (ex.: BasicOps) e o endpoint Streamable HTTP:

https://app.basicops.com/mcp

No primeiro uso, você será solicitado a entrar no BasicOps por meio do fluxo de autorização OAuth 2.1.

Claude CLI / Claude Code

O Claude CLI não suporta a atualização de tokens OAuth, então use uma API key. Gere uma em Configurações do BasicOps → API Keys e execute:

claude mcp add basicops \
  --transport http \
  https://app.basicops.com/mcp \
  --header "Authorization: Bearer bo_YOUR_API_KEY"

Ou adicione manualmente ao seu ~/.claude.json:

{
  "mcpServers": {
    "basicops": {
      "type": "http",
      "url": "https://app.basicops.com/mcp",
      "headers": {
        "Authorization": "Bearer bo_YOUR_API_KEY"
      }
    }
  }
}

Outros clientes

Use o endpoint Streamable HTTP https://app.basicops.com/mcp. Para clientes que suportam apenas SSE, use https://app.basicops.com/mcp/sse.

Clientes que suportam OAuth 2.1 serão redirecionados pelo fluxo de autorização automaticamente. Clientes que não suportam OAuth podem passar uma API key como Authorization: Bearer bo_YOUR_API_KEY.

Recursos

Suporte

Para suporte, visite basicops.com ou entre em contato conosco pelo e-mail support@basicops.com.