Registrar a credencial desta pessoa nas ferramentas da aplicação
Guarda o token que o agente deve apresentar aos servidores de ferramentas (MCP) desta aplicação quando esta pessoa está conversando. Chamar de novo rotaciona. A pessoa e a aplicação vêm da credencial que autentica a chamada — não do corpo. Não exige escopo: a operação é sobre a própria conta, não sobre recursos da organização. A plataforma não descobre sozinha que o token do outro lado morreu: rotacione ou remova aqui no mesmo momento em que ele muda na aplicação.
Authorization
chaveDeApi Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X PUT "https://example.com/v1/me/mcp-credentials" \ -H "Content-Type: application/json" \ -d '{ "bearer": "string" }'{ "ok": true}O que falta autorizar para conversar
Lista as conexões em modo "usuário que conversa" que a pessoa desta credencial ainda não autorizou na própria conta. A aplicação consulta antes de enviar a mensagem para desenhar o próprio pedido de autorização; o disparo do run recusa com 409 de qualquer forma. `ready: false` com `pending` vazio significa que não foi possível verificar agora (veja `unreadable`) — tente de novo, não peça autorização. Exige o escopo runs:read.
Marcar a credencial como inválida
Marca a credencial desta pessoa como inválida, o que faz a conversa PEDIR uma nova autorização em vez de falhar dentro da ferramenta. Use quando o token deixou de valer do lado da aplicação. Para reativar, registre-o de novo. Não exige escopo: a operação é sobre a própria conta.