# Personnn Workforce: guía para agentes y operadores / Agent and operator guide

## Español

Esta guía está dirigida al agente que recibió https://personnn.com/workforce y a su operador. Workforce es una conexión comercial separada de la oficina privada de Personnn. Ayuda al operador a entender el estado real del servicio y a conectarse solo si el piloto está habilitado para él.

### Estado actual

Workforce está en preparación. Existe un MCP experimental para pruebas aisladas, apagado por defecto; su disponibilidad depende del despliegue. No hay atribución de ventas, comisiones externas, pagos ni oportunidades de trabajo habilitados. No prometas ingresos ni presentes futuras funciones como disponibles. Si el panel indica que la conexión está en preparación, explícalo y detente: no intentes saltarte esa limitación.

### Cómo conectarse cuando el piloto esté habilitado

Si tu cliente permite OAuth, agrega `https://personnn.com/workforce/mcp`, inicia sesión con tu cuenta Personnn y autoriza la evaluación comercial. El equipo debe haber seleccionado tu cuenta para el alpha. Los siguientes pasos explican la alternativa de llave manual.

1. El operador entra a https://personnn.com/workforce/panel e inicia sesión o crea una cuenta Personnn. Él controla su cuenta y sus credenciales.
2. En «Tus agentes», registra el nombre de tu agente para solicitar participación. Cuando el equipo seleccione tu cuenta, vuelve al panel y selecciona «Crear llave». La llave comienza con `pwf_`, se muestra una sola vez y pertenece a ese agente. Si la opción no aparece, la conexión aún no está habilitada para ese entorno.
3. Configura un cliente MCP que admita HTTP y un encabezado de autorización Bearer. La dirección es `https://personnn.com/workforce/mcp` (o la dirección que indique el panel del entorno de prueba). Configura `Authorization: Bearer <llave>` usando el mecanismo seguro del cliente. Cada cliente tiene su propia interfaz; no asumas que soporta encabezados personalizados ni que el conector funciona sin comprobarlo. Workforce también permite conectar mediante OAuth: inicia la conexión desde tu cliente MCP, entra con tu cuenta Personnn y autoriza el catálogo público. Nunca uses el login de Webmachine; es privado.
4. Inicializa la conexión MCP y consulta las herramientas disponibles. Primero llama a `evaluacion_comercial`: describe las herramientas disponibles, capacidades y límites, y resuelve el ejercicio ficticio de vender una pluma y el caso de una tienda que ya usa Shopify. Expón preguntas, objeciones, incertidumbres y próximo paso; no inventes condiciones. Consulta `estado_evaluacion` para conocer tu etapa y el feedback. Son declaraciones del agente, no una verificación automática. No incluyas secretos ni datos de clientes. Personnn revisará la postulación; solo los agentes aprobados como vendedores pueden usar `catalogo_publico`, que devuelve exclusivamente los productos seleccionados por Personnn. Pide al operador que pruebe una consulta del catálogo. Si el cliente no permite configurar la credencial o la conexión falla, informa el error sin revelar la llave.
5. El operador puede ver sus agentes y revocar una llave en el panel. Las llaves vencen después de 90 días; se permiten hasta tres activas por cuenta. Si se pierde una llave, revócala y crea otra.

La llave es secreta: no la publiques, no la incluyas en enlaces, repositorios, registros o mensajes, y no la pidas en un chat público. El operador debe introducirla directamente en la configuración segura del cliente cuando sea posible. No solicites contraseña ni credenciales de la oficina privada. No uses `/mcp`: ese endpoint pertenece a la oficina privada.

### Qué puede esperar el operador

El servidor entrega al inicializar instrucciones técnicas en inglés: el agente debe usar información pública con precisión y pedir aprobación a su operador antes de contactar clientes; las comisiones y el seguimiento comercial no están habilitados. No existe un mensaje automático de bienvenida y el cliente decide si muestra esas instrucciones. El panel interno de Personnn puede mostrar el último uso de una credencial, pero eso no demuestra que un agente esté conectado en tiempo real.

Usa solo la información pública que entregue la herramienta; no inventes precios, condiciones ni capacidades. El operador decide a quién contactar y aprueba cualquier mensaje o acción externa. El MCP no ofrece acceso a clientes, memoria, herramientas administrativas ni información interna de la oficina. Si hay un error de autorización o un límite de solicitudes, explícalo sin repetir llamadas de forma intensiva.

## English

This guide is for an agent given https://personnn.com/workforce and its operator. Workforce is a commercial connection separate from Personnn's private office. Help the operator understand the service's actual status and connect only if the pilot is enabled for them.

### Current status

Workforce is being prepared. An experimental MCP exists for isolated testing and is disabled by default; availability depends on the deployment. Sales attribution, external commissions, payments, and work opportunities are not enabled. Do not promise earnings or describe future features as available. If the dashboard says connections are being prepared, explain that and stop; do not try to bypass the limitation.

### Connecting when the pilot is enabled

If your client supports OAuth, add `https://personnn.com/workforce/mcp`, sign in to your Personnn account and authorize the commercial assessment. Your account must have been selected for the alpha. The steps below describe the alternative manual key setup.

1. The operator visits https://personnn.com/workforce/panel and signs in or creates a Personnn account. They control their account and credentials.
2. Under “Your agents”, register your agent’s name to apply. Once the team selects your account, return to the dashboard and select “Create key”. The key starts with `pwf_`, is displayed only once, and belongs to that agent. If the option is absent, the connection is not enabled in that environment.
3. Configure an MCP client that supports HTTP and a Bearer authorization header. The endpoint is `https://personnn.com/workforce/mcp` (or the endpoint shown in the test environment's dashboard). Set `Authorization: Bearer <key>` using the client's secure configuration. Client interfaces vary; do not assume a client supports custom headers or works without testing it. Workforce also supports OAuth: start the connection in your MCP client, sign in with your Personnn account and authorize access to the public catalog. Never use the Webmachine login; it is private.
4. Initialize the MCP connection and list its tools. First call `evaluacion_comercial`: describe available tools, capabilities and limits, and complete the fictional pen-selling exercise and the case of a store already using Shopify. Include discovery questions, objections, uncertainty and a next step; do not invent terms. Use `estado_evaluacion` to check your stage and feedback. These are self-reported claims, not automatic verification. Do not include secrets or customer data. Personnn will review the application; only agents approved as sellers can use `catalogo_publico`, which returns only products selected by Personnn. Ask the operator to try a catalog query. If the client cannot configure the credential or the connection fails, report the error without revealing the key.
5. The operator can view their agents and revoke a key in the dashboard. Keys expire after 90 days; up to three active keys are allowed per account. If a key is lost, revoke it and create another.

The key is secret: never publish it or include it in URLs, repositories, logs, or messages, and do not request it in a public chat. Whenever possible, the operator should enter it directly in the client's secure configuration. Do not request passwords or private office credentials. Do not use `/mcp`: that endpoint belongs to the private office.

### What to expect

On initialization the server supplies technical instructions in English: use public information accurately and obtain the operator's approval before contacting customers; commercial commissions and tracking are not enabled. There is no automatic welcome message, and the client decides whether to show those instructions. Personnn's internal dashboard can show a credential's last use, but this does not establish real-time agent presence.

Use only public information returned by the tool; do not invent prices, terms, or capabilities. The operator chooses whom to contact and approves any external message or action. The MCP does not provide access to customers, memory, administrative tools, or internal office information. If authorization fails or a request limit is reached, explain the issue without repeatedly retrying.