O que faz
Read one thing found by search_context, as plain text. Takes the connection_id and ref from a hit — refs are the provider's own handle and are not guessable, with two exceptions worth knowing because they save a search: a GitHub ref is "owner/repo#123" for an issue or PR and "owner/repo:path/to/file" for a file, and a Slack ref is "channelId:messageTs". Reading a Slack ref returns the whole thread, not the one message. If this refuses with a scope message, the human narrowed that connection's consent — say which app needs reconnecting rather than retrying.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
connection_id | string | Obrigatório | From a search_context hit, or list_connections |
ref | string | Obrigatório | The hit's ref |
Anotações
As indicações que o servidor envia com esta ferramenta. Um cliente as lê para decidir se pergunta a você antes de uma chamada.
- Somente leitura
readOnlyHint: true - Não altera nada.
- Destrutiva
destructiveHint: false - Só adiciona ou lê; nada do que já existe é removido ou sobrescrito.
- Idempotente
idempotentHint: — - Não se aplica: a ferramenta não altera nada.
- Mundo aberto
openWorldHint: true - Sai do Done e chega a um app que você conectou.
Quais tokens podem chamá-la
Uma conexão feita com OAuth tem acesso total. Um token de Configurações → Acesso de agentes → Tokens MCP adicionais pode ser restringido, e um token restrito nunca enxerga além do seu projeto ou espaço de trabalho.
- Acesso totalPermitido
- Token somente leituraPermitido
- Token de um projetoRecusado
- Token de um espaço de trabalhoRecusado
Experimente
Com o Done conectado, peça ao seu assistente algo como:
“Leia a issue do GitHub para a qual a tarefa do bug aponta.”
Conecte o Done ao seu assistente
Um endpoint MCP por conta, com OAuth ou com um token. A configuração passo a passo para cada cliente: