Servidor MCP de PTC: conecte su agente de programación a PTC

El servidor MCP de PTC conecta Claude Code, Codex, Cursor y otros agentes de programación a PTC (Private Translation Cloud), el servicio de localización con IA para software.

En esta página

Qué ofrece el servidor
Modelo de sesión
Qué se le indica al agente
Verificación
Límites
Conectar

Esta página contiene el endpoint, el token, lo que ofrece el servidor y sus límites. Para saber qué hace PTC una vez que su agente está conectado, lea cómo funciona la guía del agente de PTC. Para ver los comandos de configuración, consulte Primeros pasos.

Elemento	Valor
Endpoint	`https://app.ptc.wpml.org/mcp`
Transporte	HTTP en streaming: solo POST, respuestas en JSON sin formato, sin estado
Autenticación	`Authorization: Bearer <agent token>`
Token del agente	Uno por persona. PTC lo crea cuando abre por primera vez la página Conectar su agente a PTC, o cuando aprueba el inicio de sesión de la herramienta de línea de comandos. La página lo muestra ya completado en el fragmento de configuración para su cliente
Herramienta complementaria	La herramienta de línea de comandos de PTC, que el agente instala dentro del repositorio en `.ptc/bin/ptc-cli.sh`; obligatoria
Inicio de sesión	Usted ejecuta `ptc auth login` una vez en su propio terminal y lo aprueba en el navegador. El agente nunca procesa el token
Configuración lista para usar para	Claude Code, Codex, Cursor, VS Code. Cualquier otro cliente MCP que pueda ejecutar comandos de shell se conecta con el endpoint y el encabezado
Probado con	Claude Code, Codex
Nombre del servidor	`ptc-guide`; su versión es la versión de la CLI que PTC recomienda actualmente

Qué ofrece el servidor

El servidor es una guía, no una API de traducción. Entrega a su agente una tarea a la vez y comprueba cada resultado antes de entregar la siguiente. Ofrece cinco operaciones:

Operación	Qué hace
Siguiente tarea	Devuelve la siguiente tarea para este repositorio con sus instrucciones y carga útil, o le indica al agente que PTC sigue trabajando y qué debe esperar. La primera llamada nombra el repositorio (su remoto de Git, o “local” con un nombre de proyecto) y se reincorpora a la sesión existente del repositorio si la hay. También puede nombrar un proyecto que usted comenzó en el asistente de configuración de PTC, y lo continúa. Cuando un proyecto de PTC ya utiliza el repositorio pero ninguna sesión del agente lo atiende, PTC no crea nada y le pregunta al humano: continuar ese proyecto o configurar uno nuevo. Cuando el token actúa en varias organizaciones, la primera llamada devuelve su lista y el agente le pregunta al humano cuál elegir.
Enviar	Envía el resultado de una tarea. PTC responde con un veredicto: aceptado, rechazado, necesita más u omitido, cada uno con sus motivos. Cada respuesta indica qué viene a continuación.
Estado	En qué punto se encuentra la sesión: la etapa, el progreso de la configuración, el estado de cada tarea y las preguntas que esperan al humano. Si se le pregunta por una tarea, devuelve el veredicto y los motivos de esa tarea.
Omitir	Omite una tarea por instrucción del humano, con su motivo. No se puede omitir una tarea que contiene una decisión que solo toma el humano: el censo, las convenciones, la limpieza del alcance, el canal de entrega, la primera sincronización, el presupuesto en un proyecto de pago, la auditoría de preparación mientras su punto de control está abierto, y la redacción de la configuración mientras el repositorio tiene traducciones preexistentes para importar. Las propias ayudas de PTC sí pueden omitirse.
Esperar	Espera mientras PTC termina algo por su parte (una traducción, una comprobación) y devuelve el veredicto y la siguiente tarea cuando está lista, o pide que se le llame de nuevo.

La mayoría de las tareas piden al agente que ejecute un comando de la herramienta de línea de comandos de PTC y envíe su salida: escanear el repositorio, auditar cadenas, validar un glosario, escribir notas para los traductores, informar de una ejecución, sincronizar traducciones. La herramienta imprime qué hacer a continuación en cada salida. Cuando PTC requiere una versión más reciente, imprime el comando de actualización y la guía hace que el agente lo instale.

Modelo de sesión

Un repositorio tiene una sesión. Se identifica por la URL remota del repositorio (cualquier ortografía) o, para una copia local sin remoto, por una huella digital del árbol de trabajo y un nombre de proyecto. Un segundo agente, otra máquina o un día posterior se reincorpora a la misma sesión, y PTC no crea un segundo proyecto para ella. La única excepción: cuando solo un proyecto del asistente de configuración utiliza el repositorio, el humano puede elegir configurar uno nuevo.
Un repositorio con varios productos es una suite: un proyecto de PTC, con su propia sesión, por producto; una conexión MCP y un secreto de CI para todos ellos.
Las decisiones se registran una vez y no se vuelven a preguntar: los idiomas, las convenciones, la respuesta sobre el glosario, el presupuesto, el canal de entrega.
Después de la configuración, la sesión permanece abierta para el trabajo continuo: cada ejecución de CI verificada reabre solo las cadenas nuevas o modificadas, y una ejecución sin novedades no abre nada. En una prueba gratuita, esto se detiene cuando se utilizan sus dos entregas automáticas gratuitas.
La herramienta de línea de comandos guarda la sesión, el proyecto y el token en la configuración de PTC del repositorio y en un archivo de credenciales en el directorio de inicio del usuario; el agente nunca procesa el token.

Qué se le indica al agente

Cada tarea contiene instrucciones escritas para el agente. Hay tres reglas presentes en todas ellas:

Transmitir las preguntas de PTC al humano con las palabras de PTC, y devolver las propias palabras del humano. PTC lee la respuesta por sí mismo y nunca da por válida la interpretación del agente.
Nunca responder por el humano. Los idiomas, las convenciones, el dinero, los términos y la entrega son responsabilidad del humano. Lo que el humano ya nombró en el prompt, como los idiomas de destino, cuenta como su respuesta y no se vuelve a preguntar.
Esperar a PTC en lugar de reintentar. Un envío rechazado vuelve con los motivos; el agente lo corrige y lo vuelve a enviar.

Verificación

PTC acepta un resultado solo cuando puede comprobarlo: un escaneo debe provenir de la propia herramienta de PTC; una línea de código citada debe existir en los archivos que PTC tiene para esa ejecución; una configuración debe volver byte por byte; una edición en el código fuente cuenta cuando la copia del archivo de PTC la muestra; una ejecución de CI se demuestra mediante el propio token de identidad de la plataforma de CI (GitHub Actions, GitLab CI o Bitbucket Pipelines), y una ejecución sin él se registra como no verificada. Consulte por qué un LLM por sí solo no es suficiente.

Límites

El agente debe ejecutar comandos de shell. No hay una ruta exclusiva de MCP.
Los propios avisos de permisos del agente, como aprobar un script descargado o una nueva herramienta MCP, son del agente, no de PTC; espere uno o dos en una configuración nueva. La herramienta de línea de comandos necesita bash, curl y Python 3.6 o posterior.
La revisión cubre las traducciones que hizo PTC. Las traducciones importadas del repositorio o editadas a mano se dejan tal cual.
El token actúa en cada organización que la persona administra; el token de un usuario no administrador no puede crear proyectos.
Dinero: PTC muestra el precio y espera un sí antes de cualquier trabajo de pago. Una prueba gratuita continúa dentro de su asignación gratuita y se detiene solo cuando alcanza un límite. Se le indica al agente que transmita el mensaje de actualización de PTC y que nunca compre por su cuenta.
La herramienta de línea de comandos reintenta un error del servidor o la falta de respuesta tres veces, comenzando a los 5 segundos y duplicando el tiempo. Un límite de frecuencia que nombra un retraso espera ese retraso, hasta 300 segundos. Cualquier otro error del cliente es definitivo de inmediato.
La página de la guía dentro de la aplicación de PTC es para el personal de PTC. Los clientes ven el progreso en el chat del agente y en el panel de control de PTC.

Conectar

Claude Code

claude mcp add --transport http ptc https://app.ptc.wpml.org/mcp --header "Authorization: Bearer <your agent token>"

Codex

export PTC_API_TOKEN='<your agent token>'
codex mcp add ptc --url https://app.ptc.wpml.org/mcp --bearer-token-env-var PTC_API_TOKEN

Cursor y VS Code: la página Conectar su agente a PTC proporciona un archivo listo para cada uno (.cursor/mcp.json, .vscode/mcp.json) con su token completado. Para cualquier otro cliente, añada el endpoint con el encabezado Authorization en su configuración MCP.

Luego, un prompt: Set up PTC translations.

Para continuar un proyecto que comenzó en el asistente de configuración de PTC, copie su prompt de la misma página, en Continuar un proyecto que comenzó en el asistente.

La propia herramienta de línea de comandos es de código abierto (MIT): OnTheGoSystems/ptc-cli.