Qué conecta esta guía
MCP es el protocolo que permite a tu asistente trabajar con la información de Hito. La conexión funciona con asistentes que admiten MCP por HTTP con token personal; esta guía incluye los pasos para Claude Code y Cursor. Tu asistente consulta y prepara borradores de cotización. La revisión, la emisión de facturas y los movimientos de dinero se gestionan en Hito.
Primero, tu cuenta y tu token
- La conexión se configura con tu cuenta ya creada, desde la app. Puedes crear tu cuenta o entrar a Asistente de IA si ya tienes una.
- En Asistente de IA, escribe un nombre que te ayude a reconocer la conexión y pulsa «Crear token». Guarda el token en un lugar privado: se muestra una sola vez.
- Elige Claude Code o Cursor en los pasos de abajo. Los ejemplos llevan el marcador TU_TOKEN_DE_HITO; lo sustituyes por tu token únicamente en la configuración de tu equipo.
Conexión paso a paso
Cómo conectar tu asistente
Tu asistente puede consultar clientes, cotizaciones, proyectos, facturas, gastos y reportes, y preparar borradores de cotización. Tú revisas los borradores, emites las facturas y gestionas los movimientos de dinero en Hito.
Tu token es un secreto: permite leer la información disponible para tu cuenta a través de estas herramientas. Se muestra una sola vez, al crearlo. Guárdalo en privado;puedes administrar y revocar cada conexión en la sección Asistente de IA de la app.
Los ejemplos usan TU_TOKEN_DE_HITO. Sustituye ese marcador únicamente en la configuración de tu equipo; conserva tu token fuera del chat del asistente.
- Abre una terminal en tu equipo con Claude Code instalado.
- Copia el comando y sustituye TU_TOKEN_DE_HITO por el token que acabas de guardar. Ejecútalo en la terminal; la conexión quedará disponible para tu usuario en todos tus proyectos.
- Abre Claude Code y escribe /mcp para comprobar la conexión hito. Puedes pedirle: «Consulta mis clientes en Hito».
claude mcp add --transport http --scope user --header "Authorization: Bearer TU_TOKEN_DE_HITO" hito "https://www.hito.ing/api/mcp"El comando con tu token puede quedar en el historial de la terminal. Conserva ese historial y la configuración de Claude Code en privado.
Documentación oficial de Claude Code (abre otra pestaña)- Abre el archivo .cursor/mcp.json de tu carpeta personal (en Windows, dentro de C:\Users\tu_usuario; en macOS o Linux, ~/.cursor/mcp.json). Puedes crearlo si lo necesitas.
- Copia la configuración y sustituye TU_TOKEN_DE_HITO por el token que guardaste. Si ya tienes otros servidores, añade solo la entrada hito dentro de mcpServers para conservarlos.
- Guarda el archivo y reinicia Cursor. En Customize → MCPs puedes revisar la conexión; en el chat de Agent, pide: «Consulta mis clientes en Hito».
{
"mcpServers": {
"hito": {
"url": "https://www.hito.ing/api/mcp",
"headers": {
"Authorization": "Bearer TU_TOKEN_DE_HITO"
}
}
}
}Guarda esta configuración en tu carpeta personal y mantenla fuera de repositorios y archivos compartidos.
Documentación oficial de Cursor (abre otra pestaña)Tu primera consulta
Una vez conectados, puedes pedir: «Consulta mis clientes en Hito». Para preparar una cotización, indica el cliente y los servicios que deseas incluir. El resultado queda como borrador en Hito para que revises sus líneas e importes antes de continuar. Cada petición de creación genera un nuevo borrador; puedes revisar el anterior en Cotizaciones antes de pedir otro.
Preguntas frecuentes
- ¿Qué asistentes tienen guía de conexión?
- Claude Code y Cursor. La conexión utiliza MCP por HTTP con un token personal configurado como credencial Bearer en tu equipo.
- ¿Qué puede hacer mi asistente con Hito?
- Consultar clientes, cotizaciones, proyectos, facturas, gastos y reportes disponibles para tu cuenta, y preparar cotizaciones en borrador según tu plan. Tú revisas esos borradores, emites las facturas y gestionas los movimientos de dinero desde Hito.
- ¿Dónde administro una conexión?
- En Asistente de IA, dentro de la app de Hito. Allí creas y revocas tus tokens. Cada token se muestra una sola vez al crearlo; puedes guardarlo en un lugar privado y crear otro cuando lo necesites.
La conexión y sus tokens se administran en un solo lugar: Asistente de IA, dentro de tu cuenta.