Qué hace
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
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
connection_id | string | Obligatorio | From a search_context hit, or list_connections |
ref | string | Obligatorio | The hit's ref |
Anotaciones
Las pistas que el servidor envía con esta herramienta. Un cliente las lee para decidir si te pregunta antes de llamarla.
- Solo lectura
readOnlyHint: true - No cambia nada.
- Destructiva
destructiveHint: false - Solo agrega o lee; no quita ni sobrescribe nada de lo que ya existe.
- Idempotente
idempotentHint: — - No aplica: la herramienta no cambia nada.
- Mundo abierto
openWorldHint: true - Sale de Done y llega a una app que conectaste.
Qué tokens pueden llamarla
Una conexión hecha con OAuth tiene acceso completo. Un token de Ajustes → Acceso de agentes → Tokens de MCP adicionales se puede acotar, y un token acotado nunca ve más allá de su proyecto o espacio de trabajo.
- Acceso completoPermitido
- Token de solo lecturaPermitido
- Token de un proyectoRechazado
- Token de un espacio de trabajoRechazado
Pruébala
Con Done conectado, pídele a tu asistente algo como:
“Lee el issue de GitHub al que apunta la tarea del error.”
Conecta Done a tu asistente
Un endpoint MCP por cuenta, con OAuth o con un token. Configuración paso a paso para cada cliente: