O servidor MCP não responde

Resposta curta

Se o servidor Picasi-MCP não responder, isso deve-se, na maioria das vezes, a um token de API inválido, a um ficheiro de configuração desatualizado ou ao facto de o servidor MCP não estar corretamente integrado na aplicação de IA.

Detalhes

Verificar o token:

No Picasi, abre Settings → Token de API e verifica se o token ainda existe e está ativo. Ao clicares em Mostrar token, vês o token completo. Copia-o novamente e substitui o valor no teu .mcp.json ou na tua configuração.

Verificar o ficheiro de configuração no Claude Code:

Abre o ficheiro ~/.claude.json ou o ficheiro específico do projeto .mcp.json e verifica:

O PICASI_API_TOKEN está definido corretamente?
A URL (https://picasi.app/mcp) está correta?
O JSON está sintaticamente correto (sem vírgulas em falta, sem aspas incorretas)?

Claude Desktop / ChatGPT (OAuth):

Nas ligações baseadas em OAuth, a sessão pode ter expirado. Abre o Picasi em Settings → Aplicações ligadas e verifica se a ligação ainda está ativa. Caso contrário, revoga-a e volta a ligar-te através de Settings → Ligar assistente de IA.

Recarregar o servidor MCP:

No Claude Code: Escreve no chat /mcp e verifica se picasi aparece na lista de servidores ligados. Se não for o caso, reinicia a aplicação — os servidores MCP são carregados no arranque.

Se nada disso funcionar:

Cria um novo token de API (o antigo ficará inválido), atualiza todos os ficheiros de configuração e reinicia o Assistente de IA.

Outros erros frequentes

«Permission required» ou erro de âmbito ao chamar a ferramenta

A ferramenta chamada exige um âmbito superior ao que foi concedido na ligação. Exemplo: create_source exige write, mas o token foi criado apenas com read.

Token de API: em Settings → Token de API, cria um novo token com a função adequada e introdu-lo no cliente.
OAuth (Claude.ai, ChatGPT): em Settings → Aplicações ligadas, revoga a ligação existente e, ao voltares a ligar-te, seleciona o âmbito necessário.

Resposta 401 Unauthorized

O servidor não conseguiu reconhecer nenhum token válido.

Falta o cabeçalho Authorization: Bearer … ou a cadeia de caracteres «Bearer» está vazia? Verifica na configuração do cliente.
No caso do Claude Code: a variável de ambiente PICASI_API_TOKEN pode estar definida apenas no terminal a partir do qual o cliente foi iniciado. Se o token for referenciado em .mcp.json, defini-lo diretamente nesse local.

Resposta 403 Forbidden

O token é válido, mas o recurso acedido não pertence ao Workspace ligado.

Verifica se o token foi emitido para o Workspace correto. Ao alternares entre Workspaces, é necessário um novo token.

Erros de rede ou tempos de espera esgotados

O pedido não chega ao Picasi ou é interrompido.

Verifica a VPN ou o proxy da empresa: https://picasi.app/mcp tem de estar acessível.
No caso de pedidos de análise (resumos, feedback): o cliente de IA interrompe a ligação após cerca de 30 segundos. Atualmente, estas análises não são disponibilizadas através do MCP — em vez disso, gera o relatório na aplicação Picasi e recupera-o com get_report.

A ligação é interrompida regularmente (Claude.ai / ChatGPT)

Os tokens de acesso OAuth expiram. Normalmente, o Picasi renova a ligação automaticamente; em casos raros, a ligação é interrompida de forma permanente.

Em Settings → Aplicações ligadas, revoga a ligação e volta a configurá-la através de Settings → Ligar assistente de IA.
Caso conhecido: após um período prolongado de inatividade (> 15 dias sem atualização), a ligação tem de ser reautorizada.

A versão do servidor não corresponde à do cliente

Se o cliente de IA apresentar uma mensagem de erro com a versão do protocolo (por exemplo, unsupported protocol version), é provável que o cliente esteja desatualizado.

Atualizar o cliente: Claude Code (claude update), Claude Desktop e ChatGPT através da respetiva loja.

A ligação existe, mas não há dados

list_sources devolve uma lista vazia, apesar de as fontes estarem visíveis na aplicação.

Verifica se a ligação foi estabelecida no Workspace correto. O contexto da equipa pode ser verificado com get_team_context — no campo team.name consta o Workspace atualmente ligado.