Skip to main content
El Horneross MCP Server es un servidor MCP público que te permite gestionar toda tu cuenta de Horneross desde cualquier cliente compatible con el Model Context Protocol: Claude Code, Cursor, Claude Desktop, Windsurf, y más. 
┌──────────────────┐      ┌──────────────────────────────────┐      ┌─────────────┐
│  Claude Code /   │ MCP  │  Horneross MCP Server            │ API  │  Horneross  │
│  Cursor / etc.   │ ───→ │  horneross-mcp.lucas-220.workers │ ───→ │  Platform   │
└──────────────────┘      └──────────────────────────────────┘      └─────────────┘

​
Conexión rápida

1

Obtené tu API Key

Andá a app.horneross.com → Settings → API Keys → Copiá tu clave.
2

Configurá tu cliente MCP

Agregá el servidor en la configuración de tu cliente. Abajo tenés ejemplos para cada uno.
3

Listo

Ya podés gestionar empleados de IA, datastores, conversaciones y más desde tu editor o terminal.

​
Configuración por cliente

Editá ~/.claude/.mcp.json:
{
  "mcpServers": {
    "horneross": {
      "type": "url",
      "url": "https://horneross-mcp.lucas-220.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer TU_API_KEY"
      }
    }
  }
}

​
Herramientas disponibles (25)

El servidor expone 25 herramientas organizadas en 7 categorías.

​
Empleados de IA (8)

HerramientaDescripción
list_agentsListar todos los empleados de IA de la organización
get_agentObtener detalle de un empleado (config, tools, versiones)
get_agent_configObtener configuración runtime (modelo, tools, settings)
create_agentCrear un nuevo empleado de IA
update_agentActualizar nombre, descripción o system prompt
update_agent_configCambiar modelo, temperatura, toggles de herramientas
delete_agentEliminar un empleado permanentemente
chat_with_agentEnviar un mensaje y obtener respuesta
Usá la herramienta create_agent con:
- name: "Soporte Técnico"
- description: "Atiende consultas técnicas"
- model_name: "gpt_5_2_instant"
- temperature: 0.3
- system_prompt: "Sos un agente de soporte técnico. Respondé de forma clara y concisa."
Podés activar o desactivar estas capacidades:
ToggleDescripción
use_thinkingRazonamiento extendido
use_web_searchBúsqueda web
use_deep_searchBúsqueda profunda
use_code_interpreterIntérprete de código
use_send_filesEnvío de archivos
use_markdownFormato markdown
include_sourcesIncluir fuentes
restrict_knowledgeRestringir a base de conocimiento
use_language_detectionDetección de idioma
use_conversational_modeModo conversacional
use_content_filterFiltro de contenido
use_follow_upSugerencias de seguimiento

​
Versiones (3)

Cada cambio de configuración genera una nueva versión. Podés inspeccionar y restaurar versiones anteriores.
HerramientaDescripción
list_agent_versionsListar las últimas 10 versiones
get_agent_version_configVer config completa de una versión
activate_agent_versionRestaurar (rollback) a una versión anterior

​
Conversaciones (2)

HerramientaDescripción
list_conversationsListar conversaciones recientes de un empleado
get_conversation_messagesObtener todos los mensajes de una conversación

​
Datastores (3)

HerramientaDescripción
list_datastoresListar bases de conocimiento
query_datastoreBuscar en una base con lenguaje natural
create_datasourceAgregar contenido: URL, sitio web, texto o Q&A
TipoDescripciónParámetros
web_pagePágina web individualsource_url
web_siteCrawl de sitio completosource_url
textTexto planocontent
qaPar pregunta-respuestaquestion, answer

​
Tasks / Triggers (3)

HerramientaDescripción
list_tasksListar tareas (triggers) de la organización
create_taskCrear un trigger: cron, keyword, evento, etc.
toggle_taskActivar o desactivar una tarea
TipoEjemplo
scheduleCron: 0 9 * * 1 (lunes 9am)
keywordSe activa cuando el usuario dice una palabra clave
phraseSe activa con una frase exacta
conversation_startAl iniciar conversación
lead_capturedCuando se captura un lead
form_submittedCuando se envía un formulario
human_requestedCuando el usuario pide hablar con humano

​
Herramientas del empleado (3)

HerramientaDescripción
list_agent_toolsVer herramientas configuradas en un empleado
add_agent_toolAgregar herramienta: datastore, HTTP, lead capture, etc.
remove_agent_toolQuitar herramienta por ID

​
MCP Custom (3)

HerramientaDescripción
list_custom_mcpsListar servidores MCP conectados a un empleado
add_custom_mcpConectar un servidor MCP personalizado
remove_custom_mcpDesconectar un servidor MCP

​
Autenticación

Todas las requests requieren un header Authorization con tu API Key de Horneross: 
Authorization: Bearer TU_API_KEY
La API Key se obtiene desde app.horneross.com → Settings → API Keys.

​
Protocolo

El servidor implementa MCP sobre HTTP (JSON-RPC 2.0):
  • URL: https://horneross-mcp.lucas-220.workers.dev/mcp
  • Método: POST (JSON-RPC)
  • GET: Devuelve info del servidor y lista de herramientas
# Verificar que el servidor está activo
curl https://horneross-mcp.lucas-220.workers.dev/mcp

{
  "name": "horneross",
  "version": "0.1.0",
  "description": "Horneross MCP Server — manage AI agents via Model Context Protocol",
  "toolCount": 25,
  "tools": [
    { "name": "list_agents", "description": "List all AI agents..." },
    ...
  ]
}

​
Casos de uso

Gestión desde IDE

Creá y configurá empleados de IA sin salir de tu editor de código.

Automatización CI/CD

Actualizá prompts y configuraciones como parte de tu pipeline de deploy.

Debugging

Inspeccioná conversaciones, versiones y configuraciones desde la terminal.

Versionado

Revisá el historial de cambios y restaurá versiones anteriores.

​
Próximos pasos

MCP Overview

Conectar servidores MCP externos a tus empleados

API Reference

Documentación completa de la API REST