Hubity

npx add-mcp 'https://hubity.io/api/mcp'

Servidor MCP de Hubity: conecta cualquier asistente

La tarea más común es facturar el mes: un asistente previsualiza cada factura a partir de las horas aprobadas, gastos, anticipos y avance de contratos, y luego las redacta para que una persona las revise y envíe en Hubity. La lectura requiere tu inicio de sesión y aprobación, y sigue tu rol; las tres acciones que modifican datos necesitan acceso de escritura que tú apruebas.

Gratis en Starter para hasta 3 personas. Sin necesidad de tarjeta.

Resumen

Hubity ejecuta un servidor remoto de Protocolo de Contexto de Modelo (MCP) en https://hubity.io/api/mcp. Un asistente conectado puede facturar el mes (previsualizar cada factura y luego redactarlas para revisión), leer proyectos, tareas, personas, clientes y acuerdos, propuestas y facturas, reuniones y tiempo libre, y buscar en la base de conocimientos de la empresa, siempre limitado a lo que la persona conectada puede ver.

Tres herramientas modifican datos: log_time_entry registra tiempo, create_invoice_from_proposal convierte una propuesta aceptada en un borrador de factura, y create_month_invoice_drafts redacta las facturas de un mes para revisión. Ninguna de ellas envía nada a un cliente. Las tres necesitan acceso de escritura (mcp:write), que se concede solo cuando la persona que se conecta lo aprueba en la pantalla de consentimiento de Hubity. Todas las demás herramientas solo leen.

El servidor implementa MCP 2026-07-28 sobre HTTP Streamable (solicitudes sin estado, server/discover) y aún acepta clientes que se abren con el protocolo de enlace 2025-11-25 initialize. OAuth 2.1 con PKCE es el inicio de sesión principal, y cada conexión muestra una pantalla de consentimiento de Hubity que enumera exactamente lo que el asistente puede hacer. Los códigos de acceso de solo lectura, creados en The Hub bajo Integraciones, funcionan para clientes de línea de comandos y scripts.

Conexión

Clientes compatibles: Claude, Claude Desktop, Claude Code, ChatGPT, Microsoft Copilot (a través de Copilot Studio), Grok, Gemini, Cursor, VS Code y Windsurf. Cada uno te inicia sesión en Hubity con OAuth y muestra la pantalla de consentimiento, donde eliges Permitir acceso o Denegar.

Claude y Claude Desktop

En Claude, abre Customize → Connectors → Add → Add custom connector y pega https://hubity.io/api/mcp (en Team y Enterprise, un propietario lo agrega primero en Organization settings → Connectors). Claude Desktop usa los mismos conectores. Claude te inicia sesión en Hubity y muestra la pantalla de consentimiento; permite el acceso y las herramientas aparecen.

Para usar un código de acceso de solo lectura en Claude Desktop en su lugar, agrega una entrada de puente a claude_desktop_config.json (requiere Node.js):

{
  "mcpServers": {
    "hubity": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://hubity.io/api/mcp",
               "--header", "Authorization: Bearer <access code>"]
    }
  }
}

Claude Code

Claude Code (el CLI) registra servidores con un solo comando. Para conectarte con inicio de sesión en el navegador (sin código que gestionar):

claude mcp add --transport http hubity https://hubity.io/api/mcp

Luego ejecuta /mcp dentro de Claude Code y aprueba el inicio de sesión de Hubity. Para usar un código de acceso de solo lectura en su lugar (útil para scripts y CI), pásalo como encabezado:

claude mcp add --transport http hubity https://hubity.io/api/mcp \
 --header "Authorization: Bearer <access code>"

Agrega --scope user para que la conexión esté disponible en todos tus proyectos, o confirma un .mcp.json de proyecto para compartirlo con tu equipo. Verifica con claude mcp list.

ChatGPT

1. En la configuración de ChatGPT, activa el Modo desarrollador. En un espacio de trabajo Business, Enterprise o Edu, un administrador puede necesitar permitirlo primero.
2. Crea una nueva aplicación o conector, nómbralo Hubity, pega https://hubity.io/api/mcp como la URL del servidor MCP y elige OAuth para la autenticación.
3. ChatGPT te inicia sesión en Hubity y muestra la pantalla de consentimiento. Permite el acceso y las herramientas aparecen en tus chats.

ChatGPT se conecta primero con acceso de lectura. La primera vez que le pidas registrar tiempo o redactar una factura, Hubity te pide que permitas el acceso de escritura; aprueba en la pantalla de consentimiento y la acción se ejecuta.

Microsoft Copilot

En Copilot Studio, abre el agente y luego Tools → Add a tool → New tool → Model Context Protocol. Nómbralo Hubity, pega https://hubity.io/api/mcp como la URL del servidor y elige OAuth 2.0 con Descubrimiento dinámico. Crea una nueva conexión, inicia sesión en Hubity, permite el acceso y luego agrega la herramienta al agente. Paso a paso: Hubity para Copilot.

Grok

Ve a grok.com/connectors, elige Nuevo conector, luego Personalizado, y pega https://hubity.io/api/mcp. Grok te inicia sesión en Hubity y muestra la pantalla de consentimiento. En un equipo Grok Business o Enterprise, un administrador agrega conectores primero.

Gemini

En gemini.google.com, abre Settings → Connected Apps, elige Agregar una aplicación personalizada, pega https://hubity.io/api/mcp y selecciona Siguiente. Hubity registra Gemini automáticamente, por lo que no se necesitan credenciales de cliente; inicia sesión y permite el acceso. Google actualmente ofrece aplicaciones personalizadas solo en inglés, para personas de 18 años o más en EE. UU. que usen una cuenta personal de Google.

Cursor

Agrega Hubity a ~/.cursor/mcp.json, luego inicia sesión cuando Cursor lo solicite:

{
  "mcpServers": {
    "hubity": { "url": "https://hubity.io/api/mcp" }
  }
}

VS Code

Agrega Hubity a .vscode/mcp.json, luego inicia sesión cuando VS Code lo solicite:

{
  "servers": {
    "hubity": { "type": "http", "url": "https://hubity.io/api/mcp" }
  }
}

Windsurf

Agrega Hubity a ~/.codeium/windsurf/mcp_config.json, luego inicia sesión cuando Windsurf lo solicite:

{
  "mcpServers": {
    "hubity": { "serverUrl": "https://hubity.io/api/mcp" }
  }
}

Endpoint

POST https://hubity.io/api/mcp
Content-Type: application/json
Authorization: Bearer <access code>
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/call
Mcp-Name: search_knowledge

Descubrimiento

• /.well-known/mcp/server-card.json: la tarjeta del servidor, con cada herramienta y su esquema de entrada, además de los prompts y recursos. También se sirve en /.well-known/mcp.
• /api/mcp/server.json: la entrada del Registro Oficial de MCP.
• /.well-known/oauth-authorization-server: metadatos del servidor de autorización OAuth 2.1 (RFC 8414).
• /.well-known/oauth-protected-resource/api/mcp: metadatos del recurso protegido para el endpoint MCP (RFC 9728).

Autenticación

OAuth 2.1 (recomendado)

• Endpoint de autorización: https://hubity.io/api/mcp/oauth/authorize
• Endpoint de token: https://hubity.io/api/mcp/token
• Registro de cliente: Documentos de Metadatos de ID de Cliente (un client_id HTTPS, preferido), o registro RFC 7591 para clientes públicos en https://hubity.io/api/mcp/oauth/register
• Cada autorización muestra una pantalla de consentimiento; el acceso de escritura (mcp:write) se concede solo allí
• PKCE es obligatorio; code_challenge_method debe ser S256
• Los tokens de actualización rotan en cada uso

Códigos de acceso

Para scripts y uso en línea de comandos, un administrador crea un código de acceso de solo lectura, con alcance de empresa, en The Hub → Integrations → Connect an AI assistant. Un código puede tener alcance y vencimiento cuando se crea, y puede desactivarse en cualquier momento. Cada solicitud se registra en el registro de actividad de la empresa.

Ámbitos

• knowledge:read: buscar y leer documentos de conocimiento de la empresa
• mcp:read: acceso de lectura en proyectos, tareas, personal, facturación, CRM, reuniones y tiempo libre
• mcp:write: las tres herramientas de escritura (registros de tiempo, facturas de propuestas aceptadas, borradores de facturas de un mes)

Herramientas

La lista autoritativa de herramientas, con el esquema de entrada de cada una, es tools/list a través del protocolo MCP en vivo o el array tools en la tarjeta del servidor. Categorías:

Cada herramienta de lista excepto list_pto_requests también lee un registro completo cuando se le da su id de un resultado anterior, y search_knowledge hace lo mismo para un documento.

Conocimiento

• search_knowledge

Proyectos y tareas

• list_projects, get_project_profitability
• list_tasks

Personal y organización

• list_staff, incluido a quién reporta cada persona
• list_pto_requests

Finanzas y CRM

• list_invoices
• list_proposals, create_invoice_from_proposal (escritura, necesita mcp:write)
• list_deals
• forecast_cash_flow, get_utilization_report
• preview_month_billing, lo que facturar un mes redactaría; create_month_invoice_drafts (escritura, necesita mcp:write)

Reuniones

• list_meetings

Tiempo

• log_time_entry (escritura, necesita mcp:write)

Prompts y recursos

Además de las herramientas, el servidor ofrece prompts listos para las tareas que una firma ejecuta (por ejemplo, facturar el mes, trabajo en curso de fin de mes, cobranzas, quién está sobre capacidad o una reunión diaria) y recursos que un asistente puede leer directamente para contexto, como las reuniones de hoy, un documento de conocimiento o un solo proyecto. Ambos siguen los mismos permisos que las herramientas.

Las listas actuales son prompts/list, resources/list y resources/templates/list a través del protocolo MCP en vivo, y los arrays prompts, resources y resourceTemplates en la tarjeta del servidor.

Seguridad

• Cada respuesta lleva el encabezado MCP-Protocol-Version negociado (2026-07-28 o 2025-11-25).
• Cada escritura se registra en el registro de actividad de la empresa con la persona que la autorizó.
• Aislamiento de inquilinos: cada conexión está limitada a una sola empresa; las lecturas entre empresas se rechazan en la capa de permisos.
• Cifrado: los datos se cifran al almacenarse (AES-256) y en tránsito (TLS).
• El contenido sensible (archivado, visibilidad personal, cifrado a nivel de campo) nunca se devuelve a través de MCP.
• Límites de velocidad: 1,000 solicitudes por hora por conexión de forma predeterminada, con presupuestos negociados más altos para empresas enterprise. Los endpoints de descubrimiento anónimo y OAuth tienen sus propios límites por IP más bajos para disuadir el abuso.