Integración MCP
Conecta tu agente de IA con Trabajos Online mediante el Model Context Protocol. Para acceso directo a la API REST, consulta la documentación de la API.¿Qué es MCP?
El Model Context Protocol (MCP) es un estándar abierto que permite a asistentes de IA como Claude, ChatGPT y otros interactuar con servicios externos. Con el servidor MCP de Trabajos Online, tu agente puede buscar freelancers, explorar ofertas, crear servicios y gestionar contratos — todo mediante lenguaje natural.Instalación
Configuración del Servidor MCP
No necesitas una API key para empezar. Tu agente usaráget_pairing_code para vincularse con tu cuenta automáticamente. O añade TRABAJOS_API_KEY al entorno si ya tienes una.
Vinculación con Agente (Recomendado)
La forma más sencilla de obtener acceso a la API. Tu agente genera un código de vinculación, tu operador lo introduce en el dashboard, y la API key se configura automáticamente.1
Generar código
El agente llama a
get_pairing_code y obtiene un código como TRB-A3B72
Introducir código
El agente indica al operador: “Introduce este código en trabajosonline.org/settings”
3
Verificar vinculación
El agente llama a
check_pairing_status y la API key se guarda automáticamenteNo necesitas API key para empezar — la vinculación usa identidad criptográfica del agente.
Configuración Manual de API Key (Alternativa)
Se requiere una API key para operaciones de escritura (publicar trabajos, enviar propuestas, enviar mensajes). Las operaciones de solo lectura como buscar freelancers funcionan sin ella.1
Crear cuenta
Regístrate en trabajosonline.org y crea tu cuenta
2
Generar API Key
Ve a Settings → API Keys y genera una clave
3
Configurar
Añádela a tu configuración MCP como
TRABAJOS_API_KEYQué puedes hacer
Dos roles, un solo conector. Esto es lo que desbloquea el agente para cada uno, y lo que comparten.Cliente
Contratas a alguienResumen de tu cuenta — Contratos activos, ofertas publicadas y mensajes sin leer en una sola llamada.
getDashboardEncontrar talento y servicios — Busca personas por habilidad, ciudad y tarifa, o paquetes con precio cerrado.
searchFreelancers · searchGigs · getUserProfilePublicar y gestionar ofertas — Redacta una oferta desde un briefing corto y publícala. Las freelance son gratis.
postJob · listCategoriesRevisar propuestas y contratar — Lee las propuestas recibidas y acepta una para iniciar el contrato.
getJobApplications · acceptProposalPagos que tú autorizas — El agente prepara el depósito o la liberación y te da un enlace. Nada se mueve sin tu confirmación.
createDeposit · releasePayment · checkPaymentConfirmation · getPaymentStatusFreelancer
Haces el trabajoResumen de tu cuenta — Contratos activos, propuestas enviadas y mensajes sin leer en una sola llamada.
getDashboardEncontrar ofertas — Busca por palabra clave, categoría, presupuesto, ubicación y rango salarial.
searchJobs · listCategoriesRedactar y enviar propuestas — Escribe la propuesta con tu presupuesto y plazo, y envíala.
submitProposalVender servicios — Publica un servicio con sus paquetes, precio y plazo para que te lo compren directamente.
createGigContratos y estado de cobro — Sigue tus contratos y comprueba si un pago está depositado o liberado.
listActiveContracts · getContract · getPaymentStatusComún a los dos
Herramientas Disponibles
Las siguientes herramientas están disponibles a través del servidor MCP:Herramientas Públicas (sin autenticación)
¿Cuál de las dos búsquedas uso?
searchFreelancers→ busca personas. Te dice a quién puedes contratar y cuánto cobra por hora.searchGigs→ busca servicios ya preparados, con precio cerrado y fecha de entrega. Como comprar un producto.
Herramientas Autenticadas (requieren API key)
El agente nunca mueve tu dinero
El agente pide. Tú autorizas. Igual que cuando pagas por internet y tu banco te manda confirmarlo en el móvil: la tienda pide el cobro, pero quien lo aprueba eres tú. Así funciona, paso a paso:1
El agente lo prepara
Le dices “paga los 900 € del contrato”. El agente llama a
releasePayment,
pero no se cobra nada todavía.2
Te devuelve un enlace
El agente te da una dirección tipo
trabajosonline.org/confirm-payment/73885f28...3
Tú lo confirmas
Abres el enlace, ves el contrato y el importe, y pulsas confirmar.
Ahí es cuando se mueve el dinero.
checkPaymentConfirmation el agente puede ir mirando cómo va: te dirá si
sigue pendiente, si ya se hizo, si falló o si caducó.
Dos protecciones más:
- El enlace caduca a los 15 minutos. Si lo dejas pasar, hay que pedirlo otra vez.
- Cada enlace sirve una sola vez. Aunque el agente reintente, nunca se paga dos veces.
Clientes Compatibles
- Claude Desktop — Soporte completo de MCP con uso de herramientas
- Claude Code — CLI con soporte de servidor MCP
- Cursor — Editor de código con IA e integración MCP
- Windsurf — IDE con IA y soporte MCP