Saltar al contenido

Diagnóstico de uma conexão MCP (versão e lista de ferramentas)

GET/api/oauth/connections/{id}/diagnostics

Auth
Requiere token
Quién puede:
owner
admin
SuperAdmin
X-CommunityId
X-CommunityId Envía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

Mostra qual versão do servidor e qual lista de ferramentas uma conexão recebeu por último, comparadas com o que o servidor mandaria agora. Serve para descobrir quando o assistente está com a lista de ferramentas desatualizada (guardada de uma conversa antiga). Só owner e admin do `X-CommunityId` (e SuperAdmin); conexão de outra comunidade: 404. Inclui conexões revogadas. `data.server`: `version` (`<versão do pacote>+<commit curto>`, muda a cada deploy), `commit`, `release` (quando o Heroku informa) e, para conexão ativa, `toolsFingerprint`, `toolCount`, `role` e `scopes` atuais. `lastInitialize`, `lastToolsList`, `lastToolCall` e `lastUnknownTool`: a última linha de auditoria de cada tipo (`at`, `status` e, quando houver, `tool`, `client_name`, `client_version`, `server_version`, `tools_fingerprint`, `tool_count`, `renamed_to`), ou `null`. `listUpToDate`: se o `tools_fingerprint` da última lista entregue bate com o atual (`null` quando não há o que comparar).

Parámetros

NombreDóndeTipoDescripción
idobligatoriopathstring (uuid)

Headers

NombreTipoDescripción
X-CommunityIdopcionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Respuestas

CódigoDescripción
200Diagnóstico da conexão.
401Token ausente, inválido ou expirado.
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.

Ejemplo con curl

curl -X GET "https://api.memberfy.net/api/oauth/connections/<id>/diagnostics" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"