¿Vas a conectar un cliente de IA existente? Consulta la configuración del plugin de Paperzilla para Claude, ChatGPT, Codex y OpenClaw.
Configura el transporte y los permisos
- Configura tu cliente MCP con la URL
https://paperzilla.ai/api/mcpy selecciona Streamable HTTP. Deja que el SDK negocie la versión de MCP y use los metadatos de descubrimiento de OAuth que publica el servidor. - Solicita
catalog:readpara verificar el acceso de la cuenta y leer resúmenes públicos. Añadeprojects:readsi el agente lee las listas de artículos de los proyectos del usuario. Añadeoffline_accesssi el agente necesita renovar la conexión entre ejecuciones. - Configura la redirección de OAuth en tu SDK. Para un cliente público, usa el flujo de código de autorización con PKCE S256, una URI de redirección que coincida con la registrada y configura
token_endpoint_auth_methodcon el valornone. Envía el recurso anunciado,https://paperzilla.ai/api/mcp, tanto en la solicitud de autorización como en el intercambio del código. Consulta la referencia de OAuth de Paperzilla para ver las opciones de registro y las URL de los metadatos.
Autoriza la cuenta
- Inicia el flujo de OAuth desde tu cliente y abre la URL de autorización en el navegador del usuario. El usuario inicia sesión en Paperzilla y revisa el acceso solicitado.
- Cuando el navegador vuelva a tu URL de redirección, deja que el SDK verifique el estado de OAuth e intercambie el código. Guarda las credenciales de forma segura junto con la conexión del usuario correspondiente. Envía el token de acceso de OAuth en el encabezado Authorization de las solicitudes MCP.
- Si solicitaste permiso para renovar el acceso, haz las renovaciones de cada conexión de una en una y guarda el nuevo token de actualización después de cada intercambio correcto. Si el usuario revoca el acceso, inicia una nueva autorización en el navegador antes de reanudar las lecturas.
Verifica el acceso antes de activar el agente
- Usa tu SDK para listar las herramientas y llama a
account_statuscon un objeto de argumentos vacío. Comprueba los permisos concedidos. Una cuenta puede leer resúmenes públicos aunque todavía no tenga proyectos propios. - Llama a
public_digests_searchcon los argumentos siguientes para probar una lectura pública. Usa el identificador de la serie conpublic_digest_issues_listy abre una edición de esa lista conpublic_digest_get. Consulta la referencia de herramientas de MCP.
- Si solicitaste acceso a listas privadas, llama a
projects_listy usa uno de los valores deproject_iddevueltos confeed_get. Si hay más resultados, usa el valor denext_offsetpara pedir la página siguiente. Si la cuenta no tiene proyectos, usa la URL de configuración que devuelveaccount_status.
Diagnostica problemas de conexión
- Si falla el descubrimiento o la autorización, prueba la misma URL y los mismos permisos en MCP Inspector. Comprueba la URL de redirección y que el SDK envíe el recurso durante la autorización y el intercambio del código.
- Si una herramienta necesita un permiso que no solicitaste, inicia una nueva autorización que lo incluya. Renovar el token actual conserva los permisos existentes.
- Si estás probando una ejecución desatendida, autoriza el acceso primero en el navegador. Ejecuta la tarea con la conexión guardada y comprueba que pueda renovarla antes de confiar en una programación. Puedes revocar una conexión de prueba desde Conectar clientes de IA.