El servidor MCP no responde

Consejo

Directamente en la app: picasi.app/workspace/ai-connections

Respuesta breve

Si el servidor MCP de Picasi no responde, suele deberse a un token de API no válido, a un archivo de configuración obsoleto o a que el servidor MCP no está integrado correctamente en la aplicación de IA.

Detalles

Comprobar el token:

En Picasi, abre Configuración → Token de API y comprueba si el token sigue existiendo y está activo. Si haces clic en Mostrar token, verás el token completo. Cópialo de nuevo y sustituye el valor en tu .mcp.json o en tu configuración.

Comprobar el archivo de configuración en Claude Code:

Abre ~/.claude.json o el archivo específico del proyecto .mcp.json y comprueba:

• ¿Está PICASI_API_TOKEN configurado correctamente?
• ¿Es correcta la URL (https://picasi.app/mcp)?
• ¿Es sintácticamente correcto el JSON (sin comas que falten ni comillas incorrectas)?

Claude Desktop / ChatGPT (OAuth):

En las conexiones basadas en OAuth, es posible que la sesión haya caducado. Abre Picasi en Configuración → Aplicaciones conectadas y comprueba si la conexión sigue activa. Si no es así, revócala y vuelve a conectarte a través de Configuración → Conectar asistente de IA.

Recargar el servidor MCP:

En Claude Code: Escribe en el chat /mcp y comprueba si picasi aparece en la lista de servidores conectados. Si no es así, reinicia la aplicación; los servidores MCP se cargan al iniciarla.

Si nada de esto funciona:

Crea un nuevo token de API (el antiguo dejará de ser válido), actualiza todos los archivos de configuración y reinicia el asistente de IA.

Otros errores frecuentes

«Permission required» o error de ámbito al llamar a una herramienta

La herramienta a la que se accede requiere un ámbito mayor que el concedido al establecer la conexión. Ejemplo: create_source requiere write, pero el token solo se creó con read.

• Token de API: en Configuración → Token de API, crea un nuevo token con el rol adecuado e introdúcelo en el cliente.
• OAuth (Claude.ai, ChatGPT): en Configuración → Aplicaciones conectadas, revoca la conexión existente y, al volver a conectarte, selecciona el ámbito necesario.

Respuesta 401 Unauthorized

El servidor no ha podido detectar ningún token válido.

• ¿Falta el encabezado Authorization: Bearer … o la cadena «Bearer» está vacía? Compruébalo en la configuración del cliente.
• En el caso de Claude Code: es posible que la variable de entorno PICASI_API_TOKEN solo esté definida en el terminal desde el que se inició el cliente. Si se hace referencia al token en .mcp.json, introdúcelo directamente allí.

Respuesta 403 Forbidden

El token es válido, pero el recurso al que se accede no pertenece al espacio de trabajo conectado.

• Comprueba si el token se ha emitido para el espacio de trabajo correcto. Al cambiar de espacio de trabajo, se necesita un nuevo token.

Errores de red o tiempos de espera agotados

La solicitud no llega a Picasi o se interrumpe.

• Comprueba la VPN o el proxy de la empresa: debe poder accederse a https://picasi.app/mcp.
• En el caso de las solicitudes de análisis (resúmenes, comentarios): el cliente de IA se interrumpe tras unos 30 segundos. Actualmente, estos análisis no se ofrecen a través de MCP; en su lugar, genera el informe en la aplicación de Picasi y recógelo con get_report.

La conexión se interrumpe con frecuencia (Claude.ai / ChatGPT)

Los tokens de acceso OAuth caducan. Picasi suele renovar la conexión automáticamente; en casos excepcionales, la conexión se interrumpe de forma permanente.

• En Ajustes → Aplicaciones conectadas, revoca la conexión y vuelve a configurarla a través de Ajustes → Conectar asistente de IA.
• Caso conocido: tras un periodo prolongado de inactividad (> 15 días sin actualización), es necesario volver a autorizar la conexión.

La versión del servidor no coincide con la del cliente

Si el cliente de IA muestra un mensaje de error con una versión de protocolo (p. ej., unsupported protocol version), es probable que el cliente sea demasiado antiguo.

• Actualizar el cliente: Claude Code (claude update), Claude Desktop y ChatGPT a través de sus respectivas tiendas de aplicaciones.

Hay conexión, pero no hay datos

list_sources devuelve una lista vacía, aunque en la aplicación se ven las fuentes.

• Comprueba si te has conectado al espacio de trabajo correcto. El contexto del equipo se puede verificar con get_team_context; en el campo team.name aparece el espacio de trabajo al que estás conectado actualmente.