> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Profound Docs

> Conoce las herramientas de Profound Docs disponibles a través de Profound MCP

Profound MCP ofrece a los asistentes de IA herramientas para buscar, leer, escribir y gestionar documentos en Profound Docs, los documentos colaborativos de la plataforma Profound, como memorandos y briefs. Para conectar tu cliente MCP al servidor alojado, consulta las [guías de conexión](/es/mcp/common-mcp-clients).

<Note>
  Los documentos de Profound Docs no son documentos de la Knowledge Base. Para añadir contenido que los asistentes de IA y los Agents busquen y recuperen, usa en su lugar la herramienta `add_knowledge_base_document`. Consulta [Knowledge Base](/es/mcp/capabilities/knowledge-base-capabilities).
</Note>

## Cómo funcionan las herramientas en conjunto

<Steps>
  <Step title="Encuentra un documento">
    Pregunta si existe un documento o cuáles han cambiado recientemente. El asistente busca en los nombres de los documentos con `list_docs` y te enlaza cada resultado.
  </Step>

  <Step title="Léelo">
    Pide un resumen o el texto completo. El asistente lee el documento con `get_doc`, revisando el inicio de forma predeterminada y cargando el cuerpo completo cuando la tarea lo requiere.
  </Step>

  <Step title="Crea o revisa">
    Pide un documento nuevo y el asistente lo redacta y lo guarda con `create_doc`. Pide un cambio en uno existente y reescribe el documento con `replace_doc_content`.
  </Step>

  <Step title="Cambia el nombre, vuelve a compartir o elimina">
    Pide cambiar el nombre de un documento o quién lo ve (`update_doc`), o eliminar uno que el asistente creó anteriormente (`delete_doc`).
  </Step>
</Steps>

## Comportamiento y seguridad

Las herramientas de escritura usan el modo de vista previa de forma predeterminada: el asistente recibe primero un plan del cambio y nada cambia hasta que aplica ese plan. La excepción es `delete_doc`, que no tiene vista previa y elimina en la primera llamada.

### Comportamientos

| Comportamiento | Qué significa |
| - | - |
| Vista previa antes de aplicar | `create_doc`, `replace_doc_content` y `update_doc` devuelven primero un plan e informan `applied: true` solo cuando se aplica un cambio |
| Escrituras de documento completo | `replace_doc_content` sobrescribe todo el cuerpo y borra los comentarios y las pestañas en cada llamada, incluidas las reescrituras completas y parciales |
| Prevalece la última escritura | La herramienta de reemplazo no comprueba versiones. Cuando dos autores reemplazan el mismo documento, la escritura posterior sobrescribe la anterior, sin posibilidad de revertir |
| Restricciones de cambio de nombre y de uso compartido | `update_doc` solo funciona con documentos creados a través de MCP o que tú mismo creaste en la plataforma Profound. Solo el creador de un documento puede cambiar su visibilidad |
| Restricciones de eliminación | `delete_doc` solo funciona con documentos creados a través de MCP. Pedir que se elimine uno que creaste en la plataforma Profound devuelve `deleted: false` |
| Datos en vivo | Las herramientas leen de la API de Profound, por lo que los resultados reflejan tu acceso y tus datos actuales |

### Indicaciones de MCP

Las siguientes indicaciones de MCP están definidas en las herramientas de escritura.

| Herramienta | Indicaciones | Qué significa |
| - | - | - |
| `create_doc` | `destructiveHint: false`, `idempotentHint: true` | Crear dos veces con el mismo `name` devuelve el documento existente en lugar de una segunda copia, y la creación nunca sobrescribe un documento existente |
| `replace_doc_content` | `destructiveHint: true`, `idempotentHint: true` | La llamada sobrescribe todo el cuerpo y borra los comentarios y las pestañas |
| `update_doc` | `destructiveHint: true`, `idempotentHint: true` | Un cambio de nombre impide de forma permanente que el título siga al primer encabezado, y volver a enviar `visibility: organization` reduce el acceso de edición existente a solo lectura |
| `delete_doc` | `destructiveHint: true`, `idempotentHint: true` | Un documento eliminado no se puede restaurar mediante ninguna API, y una llamada repetida informa `deleted: false` |

Todas las herramientas de escritura también definen `openWorldHint: true`, que indica a tu cliente MCP que las escrituras se realizan en el entorno compartido y en vivo, por lo que el cliente puede pedirte confirmación antes de ejecutarlas.

## Herramientas de Profound Docs

| Herramienta | Uso |
| - | - |
| `list_docs` | Buscar documentos por nombre y leer sus detalles |
| `get_doc` | Leer un documento, como vista previa o completo |
| `create_doc` | Crear un documento nuevo a partir de contenido redactado |
| `replace_doc_content` | Reemplazar todo el cuerpo de un documento, borrando comentarios y pestañas |
| `update_doc` | Cambiar el nombre de un documento, quién puede verlo, o ambos |
| `delete_doc` | Eliminar un documento creado por esta integración |

<AccordionGroup>
  <Accordion title="list_docs">
    Busca documentos y sus detalles, como el nombre, el propietario, la visibilidad y el enlace (`url`). Los resultados se ordenan del modificado más recientemente al más antiguo y nunca incluyen el cuerpo del documento.

    **Ejemplos de prompts**:

    * "¿Ya tenemos un documento sobre nuestra estrategia de AEO?"
    * "¿Qué documentos de Profound cambiaron más recientemente?"

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `q` | No | `null` | Coincidencia aproximada con el nombre del documento. No busca en el cuerpo del documento |
    | `sort` | No | `null` | `recency` es el único valor aceptado y coincide con el orden predeterminado. Cualquier otro valor devuelve un error |
    | `organization_id` | No | `null` | Organización cuyos documentos se listan. De forma predeterminada, la organización de la sesión (si se resuelve). Obligatorio cuando la cuenta tiene acceso a más de una organización |
    | `limit` | No | `20` | Documentos devueltos por página de resultados, de 1 a 50. Los valores fuera del rango devuelven un error |
    | `cursor` | No | `null` | El `next_cursor` de una llamada anterior, usado para obtener la página siguiente. Caduca una hora después de emitirse |

    **Limitaciones**:

    * La herramienta no filtra por autor ni por propietario del documento. Para encontrar los documentos de una persona, el asistente lista todos los documentos y lee el propietario de cada fila, lo que puede tardar un poco.
    * La herramienta no devuelve un recuento total de documentos.
  </Accordion>

  <Accordion title="get_doc">
    Lee un documento. La vista previa predeterminada devuelve solo el inicio del cuerpo. Cuando la tarea necesita el texto completo o la discusión sobre él, el asistente carga el cuerpo completo o los comentarios.

    **Ejemplos de prompts**:

    * "Resume el memorando de estrategia de AEO."
    * "Lee la retrospectiva del Q3 completa, incluidos los comentarios que dejaron las personas."

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `doc_id` | Sí | - | El ID del documento, obtenido de `list_docs` o de la URL de un documento |
    | `organization_id` | Sí | - | La organización propietaria del documento |
    | `preview` | No | `true` | `true` devuelve el inicio del cuerpo; `false` devuelve el cuerpo completo |
    | `include_comments` | No | `false` | `true` también devuelve los comentarios, cada uno con su texto y el pasaje en el que se dejó |
  </Accordion>

  <Accordion title="create_doc">
    Crea un documento nuevo a partir del contenido que redactó el asistente. La herramienta recibe el cuerpo completo en una sola llamada.

    **Ejemplos de prompts**:

    * "Escribe una retrospectiva de AEO del Q3 basada en los datos de visibilidad de este trimestre y guárdala como documento de Profound."
    * "Redacta un brief de competidores y guárdalo en Profound para poder compartirlo más tarde."

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `name` | Sí | - | Título del documento, de 256 bytes como máximo. También es su identidad dentro de una organización |
    | `content_markdown` | Sí | - | El cuerpo completo en Markdown, de 1,000,000 bytes como máximo |
    | `organization_id` | No | `null` | Organización en la que crear el documento. De forma predeterminada, la organización de la sesión |
    | `preview` | No | `true` | Cuando es `true`, devuelve el plan sin crear el documento; cuando es `false`, lo crea |

    **Notas**:

    * Los títulos de los documentos son únicos dentro de una organización: crear un documento con un título que ya existe devuelve el documento existente y descarta el cuerpo nuevo.
    * Los documentos nuevos solo son visibles para su creador.
    * Cuando la llamada falla entre la creación del documento y el almacenamiento de su cuerpo, el documento existe pero está vacío, y la respuesta informa `content_written: false`. Un reintento devuelve el mismo documento vacío en lugar de rellenarlo.
  </Accordion>

  <Accordion title="replace_doc_content">
    <Warning>
      Úsala con precaución: esta herramienta reemplaza todo el cuerpo del documento, borra todas las pestañas excepto la principal y borra todos los comentarios.
    </Warning>

    Reemplaza el contenido de un documento con texto nuevo. Cualquier cambio en un documento existente, desde marcar una casilla hasta reescribir una sección, pasa por esta herramienta.

    **Ejemplos de prompts**:

    * "Añade una sección sobre prompts de compras al memorando de estrategia de AEO."
    * "Corrige las erratas de la retrospectiva del Q3."

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `doc_id` | Sí | - | El documento que se reemplazará, obtenido de `list_docs` o de su URL |
    | `content` | Sí | - | El cuerpo nuevo completo en Markdown. Un valor vacío borra el documento |
    | `organization_id` | No | `null` | De forma predeterminada, la organización de la sesión |
    | `skip_title_sync` | No | `false` | `true` conserva el título actual. De forma predeterminada, el título sigue al primer encabezado del contenido nuevo |
    | `preview` | No | `true` | Cuando es `true`, informa qué cambiaría la sobrescritura; cuando es `false`, escribe |

    **Notas**:

    * Cuando se reemplaza el contenido del documento, el título se actualiza para coincidir con el primer encabezado del contenido nuevo, a menos que `skip_title_sync` sea `true`.
  </Accordion>

  <Accordion title="update_doc">
    Cambia el nombre de un documento, quién puede verlo, o ambos en una sola llamada.

    **Ejemplos de prompts**:

    * "Cambia el nombre del memorando de estrategia a 'AEO strategy H2'."
    * "Haz que la retrospectiva del Q3 sea visible para toda la organización."

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `doc_id` | Sí | - | El documento cuyo nombre o uso compartido se cambiará |
    | `name` | No | `null` | Título nuevo, de 256 bytes como máximo. Omítelo cuando el título no cambie |
    | `visibility` | No | `null` | `invited_only` u `organization`, que es de solo lectura. Omítelo cuando el uso compartido no cambie |
    | `organization_id` | No | `null` | De forma predeterminada, la organización de la sesión |
    | `preview` | No | `true` | Cuando es `true`, devuelve el plan sin cambiar nada; cuando es `false`, aplica |

    **Notas**:

    * Se requiere al menos uno de `name` o `visibility`. Una llamada sin ninguno devuelve un error.
    * Cambiar el nombre de un documento no cambia su primer encabezado e impide de forma permanente que el título lo siga. Por ejemplo, si cambias el nombre de "AEO strategy" a "AEO strategy H2", el primer encabezado del documento sigue diciendo "AEO strategy".
    * Solo lectura es el único nivel de acceso que `update_doc` puede conceder a todos los miembros de una organización. Si todos los miembros de una organización ya tienen acceso de edición, establecer `visibility` en `organization` a través de MCP reduce ese acceso a solo lectura.
    * La herramienta solo funciona con documentos creados a través de MCP o que tú mismo creaste en la plataforma Profound. Un documento compartido contigo, incluso con acceso de edición, no se puede renombrar ni volver a compartir, y solo su creador puede cambiar su visibilidad.
  </Accordion>

  <Accordion title="delete_doc">
    Elimina un documento que el asistente creó anteriormente a través de una conexión MCP, como un borrador que resultó incorrecto o un duplicado. Es la única herramienta de escritura sin modo de vista previa.

    **Ejemplos de prompts**:

    * "Elimina el borrador que creaste antes, nos quedamos con la versión final."
    * "Ese brief resultó ser un duplicado, elimínalo."

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `doc_id` | Sí | - | El documento que se eliminará, obtenido de `list_docs` o de su URL |
    | `organization_id` | No | `null` | De forma predeterminada, la organización de la sesión |

    **Notas**:

    * La eliminación solo funciona con documentos creados a través de MCP y solo por parte de su creador.
    * Las eliminaciones son definitivas: no puedes deshacerlas.
  </Accordion>
</AccordionGroup>

## Recursos

| URI del recurso | Descripción |
| - | - |
| `file:///profound/docs-guide` | La guía de redacción: en qué se diferencia un documento de un documento de la Knowledge Base, cuándo crear y cuándo reemplazar, cómo sobrescribir un documento completo de forma segura y quién puede ver un documento nuevo |
| `file:///profound/glossary/doc` | La definición de un Profound Doc |