BasicOps

Proyectos, tareas y comunicación diseñados para IA.

Documentación

Servidor MCP de BasicOps

El servidor oficial de Model Context Protocol (MCP) para BasicOps, una plataforma de gestión de proyectos para tareas, notas y colaboración en equipo.

Conecta cualquier cliente de IA compatible con MCP (Claude, Cursor, Windsurf, etc.) a tu espacio de trabajo de BasicOps y gestiona tu trabajo usando lenguaje natural.

Endpoints

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

Autenticación

El servidor MCP de BasicOps admite dos métodos de autenticación:

OAuth 2.1 (recomendado)

La mayoría de los clientes MCP (Claude Desktop, Cursor, Windsurf, etc.) admiten OAuth 2.1. Cuando te conectes, serás redirigido a través del flujo de autorización OAuth 2.1 para otorgar acceso a tu espacio de trabajo de BasicOps. No se requiere gestión manual de tokens.

Clave de API

Para clientes que no admiten la renovación de tokens OAuth (como Claude CLI / Claude Code), puedes autenticarte usando una clave de API de BasicOps.

En BasicOps, ve a Configuración → Claves de API y genera una nueva clave. Cópiala; solo se muestra una vez.
Configura tu cliente MCP para enviar la clave como token Bearer en el encabezado Authorization (consulta las instrucciones específicas por cliente a continuación).

Las claves de API no caducan de forma predeterminada, pero pueden revocarse en cualquier momento desde Configuración → Claves de API.

Funciones

El servidor MCP de BasicOps expone herramientas para trabajar con todo tu espacio de trabajo de BasicOps:

Proyectos — crear, actualizar, listar y archivar proyectos
Tareas y subtareas — crear, actualizar, asignar, priorizar y completar tareas
Secciones — organizar tareas dentro de proyectos usando secciones
Notas — crear y gestionar notas de proyectos
Mensajes — publicar y responder mensajes en proyectos y tareas
Plantillas — listar y gestionar plantillas de proyectos
Usuarios — consultar miembros del equipo e información del usuario actual
Archivos adjuntos — subir y adjuntar archivos a tareas

Primeros pasos

1. Configura tu cliente MCP

Claude Desktop

En Claude Desktop, agrega un nuevo conector MCP usando la opción de conector personalizado. Ingresa un nombre (por ejemplo, BasicOps) y el endpoint HTTP Streamable:

https://app.basicops.com/mcp

En el primer uso, se te pedirá iniciar sesión en BasicOps mediante el flujo de autorización OAuth 2.1.

Claude CLI / Claude Code

Claude CLI no admite la renovación de tokens OAuth, así que usa una clave de API en su lugar. Genera una en Configuración → Claves de API de BasicOps y luego ejecuta:

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

O agrégalo manualmente a tu ~/.claude.json:

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

Otros clientes

Usa el endpoint HTTP Streamable https://app.basicops.com/mcp. Para clientes que solo admiten SSE, usa https://app.basicops.com/mcp/sse en su lugar.

Los clientes que admiten OAuth 2.1 serán redirigidos a través del flujo de autorización automáticamente. Los clientes que no admiten OAuth pueden pasar una clave de API como Authorization: Bearer bo_YOUR_API_KEY.

Recursos

Soporte

Para soporte, visita basicops.com o contáctanos en support@basicops.com.