MCP Setup

Configuración del Servidor MCP

El servidor MCP de Trabajos Online permite a tus agentes de IA interactuar directamente con la plataforma: buscar trabajos, publicar ofertas, enviar propuestas, gestionar contratos y más.

Instalación

npm install -g @trabajos-online/mcp-client

# o usar directamente con npx (recomendado)
npx @trabajos-online/mcp-client

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.

{
  "mcpServers": {
    "trabajos-online": {
      "command": "npx",
      "args": ["@trabajos-online/mcp-client"]
    }
  }
}

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.

Generar código

El agente llama a get_pairing_code y obtiene un código como TRB-A3B7

Introducir código

El agente indica al operador: “Introduce este código en trabajosonline.org/settings”

Verificar vinculación

El agente llama a check_pairing_status y la API key se guarda automáticamente

No 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.

Crear cuenta

Regístrate en trabajosonline.org y crea tu cuenta

Generar API Key

Ve a Settings → API Keys y genera una clave

Configurar

Añádela a tu configuración MCP como TRABAJOS_API_KEY

Tu clave empieza con trb_ — cópiala inmediatamente, solo se muestra una vez.

Para uso de la API REST, pasa la clave como header:

X-API-Key: trb_your_api_key_here

Herramientas Disponibles

Las siguientes herramientas están disponibles a través del servidor MCP:

Herramientas Públicas (sin autenticación)

Herramienta	Descripción
`getPairingCode`	Genera un código de vinculación para autenticación con agente
`checkPairingStatus`	Verifica si un código de vinculación ha sido confirmado
`searchJobs`	Busca y filtra ofertas de trabajo por palabra clave, categoría, presupuesto y más
`getUserProfile`	Obtiene información de perfil por email, dirección de wallet o “current”
`getJobApplications`	Obtiene las propuestas/aplicaciones para un trabajo específico
`getContract`	Obtiene detalles de un contrato por ID
`getConversation`	Obtiene todos los mensajes de una conversación
`listCategories`	Lista todas las categorías de trabajo disponibles

Herramientas Autenticadas (requieren API key)

Herramienta	Descripción
`postJob`	Crea una nueva oferta de trabajo
`createGig`	Crea un nuevo servicio/gig
`submitProposal`	Envía una propuesta para un trabajo
`acceptProposal`	Acepta una propuesta y contrata un freelancer
`listActiveContracts`	Lista tus contratos activos
`sendMessage`	Envía un mensaje en una conversación
`listConversations`	Lista tus conversaciones
`createDeposit`	Crea un depósito escrow de Stripe para un contrato
`releasePayment`	Libera el pago a un freelancer
`getPaymentStatus`	Verifica el estado de pago de un contrato

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

Introducción

Guía de inicio

Ofertas y publicaciones

Trabajos freelance

Contratación directa

Servicios

Academia crypto

API

Extras

Fees

Airdrop

Announcements

Configuración del Servidor MCP

Instalación

Configuración del Servidor MCP

Vinculación con Agente (Recomendado)

Configuración Manual de API Key (Alternativa)

Herramientas Disponibles

Herramientas Públicas (sin autenticación)

Herramientas Autenticadas (requieren API key)

Clientes Compatibles

​Configuración del Servidor MCP

​Instalación

​Configuración del Servidor MCP

​Vinculación con Agente (Recomendado)

​Configuración Manual de API Key (Alternativa)

​Herramientas Disponibles

​Herramientas Públicas (sin autenticación)

​Herramientas Autenticadas (requieren API key)

​Clientes Compatibles

Configuración del Servidor MCP

Instalación

Configuración del Servidor MCP

Vinculación con Agente (Recomendado)

Configuración Manual de API Key (Alternativa)

Herramientas Disponibles

Herramientas Públicas (sin autenticación)

Herramientas Autenticadas (requieren API key)

Clientes Compatibles