Herramientas MCP — Resumen

Derechos de acceso

Las herramientas MCP se asignan a tres niveles de ámbito:

Ámbito	Significado
`read`	Acceso de solo lectura; no permite crear, editar ni eliminar
`write`	Lectura y escritura de fuentes, canales y Inbox; sin acceso a la configuración del equipo
`admin`	Acceso completo a MCP, incluida la configuración del equipo

En las conexiones OAuth, el ámbito seleccionado durante la autorización limita las herramientas a las que se puede acceder. En el caso de los tokens de API, el rol del token determina el nivel máximo de acceso.

Herramientas de lectura

Todas las herramientas de lectura requieren, como mínimo, el ámbito read.

`search_updates`

Busca en las actualizaciones por términos de búsqueda, fuentes, etiquetas y periodo.

Ámbito necesario: read

Parámetro	Tipo	Descripción
`query`	Cadena	Término de búsqueda de texto completo (opcional)
`source_id`	Cadena	Actualizaciones de una fuente concreta (opcional)
`tags`	Matriz	Etiquetas de actualización por las que se filtra (opcional)
`folder`	Cadena	`inbox`, `saved` o `dropped` (opcional)
`source_ownership`	Cadena	`all` (por defecto), `own` (solo fuentes propias) o `competitor` (solo fuentes ajenas)
`limit`	Entero	Número de resultados (por defecto: 20, máximo: 100)

El filtro source_ownership utiliza el campo is_own de la fuente. Es el equivalente al filtro de propiedad de la interfaz de usuario de la Inbox y permite al asistente de IA centrarse específicamente solo en la presencia propia o solo en la de la competencia.

`get_update_details`

Devuelve el contenido completo de una única actualización.

Ámbito requerido: read

Parámetro	Tipo	Descripción
`update_id`	Cadena	ID de la actualización

`list_sources`

Enumera todas las fuentes del espacio de trabajo.

Ámbito requerido: read

Parámetro	Tipo	Descripción
`is_own`	Booleano	`true` = solo fuentes propias, `false` = solo competidores, omitir = todas

Cada fuente devuelta contiene el campo is_own, para que los asistentes de IA puedan distinguir entre su propia presencia y la de la competencia sin tener que realizar una segunda consulta.

`list_reports`

Enumera los informes de IA disponibles.

Ámbito requerido: read

Parámetro	Tipo	Descripción
`type`	Cadena	`summary`, `feedback`, `list`, `linkedin_post`, `conversation_starters` (opcional)
`limit`	Entero	Número (por defecto: 10)

`get_report`

Devuelve el contenido completo de un informe.

Ámbito requerido: read

Parámetro	Tipo	Descripción
`report_id`	Cadena	ID del informe

`get_team_context`

Devuelve el contexto de IA del espacio de trabajo: metadatos del equipo (nombre, idioma, zona horaria), URL del sitio web, documentos de contexto y la configuración de propiedad.

Ámbito requerido: read

No hay parámetros obligatorios.

La respuesta contiene en el bloque context:

website_url – URL de la organización almacenada
is_own_sources_configured – true, siempre que al menos una fuente esté marcada como propia
own_sources_count – número de fuentes propias

Los asistentes de IA solo deben ofrecer comparativas de Voice Share o Momentum si is_own_sources_configured es true; de lo contrario, falta la base de comparación.

`list_tags`

Enumera todas las etiquetas del espacio de trabajo.

Ámbito requerido: read

Parámetro	Tipo	Descripción
`type`	Cadena	`sources`, `channels`, `updates` (opcional)

Herramientas de escritura

Todas las herramientas de escritura requieren, como mínimo, el ámbito write.

`create_source`

Crea una nueva fuente.

Ámbito requerido: write

Parámetro	Tipo	Descripción
`url`	Cadena	URL del sitio web de la fuente
`name`	Cadena	Nombre interno
`tags`	Matriz	ID de etiquetas (opcional)

`update_source`

Modifica el nombre, la URL o las etiquetas de una fuente existente.

Ámbito requerido: write

Parámetro	Tipo	Descripción
`source_id`	Cadena	ID de la fuente
`name`	Cadena	Nuevo nombre (opcional)
`url`	Cadena	Nueva URL (opcional)

`delete_source`

Elimina una fuente, incluidos todos sus canales y actualizaciones.

Ámbito requerido: write

Parámetro	Tipo	Descripción
`source_id`	Cadena	ID de la fuente

`create_channel`

Crea un canal manualmente.

Ámbito requerido: write

Parámetro	Tipo	Descripción
`source_id`	Cadena	ID de la fuente principal
`url`	Cadena	URL del canal
`name`	Cadena	Nombre del canal (opcional)

`update_channel`

Modifica el nombre o la descripción de un canal.

Ámbito requerido: write

Parámetro	Tipo	Descripción
`channel_id`	Cadena	ID del canal
`name`	Cadena	Nuevo nombre (opcional)

`delete_channel`

Elimina un canal.

Ámbito requerido: write

Parámetro	Tipo	Descripción
`channel_id`	Cadena	ID del canal

`toggle_channel`

Activa o desactiva un canal.

Ámbito requerido: write

Parámetro	Tipo	Descripción
`channel_id`	Cadena	ID del canal
`active`	Booleano	`true` = activo, `false` = inactivo

`create_tag`

Crea una nueva etiqueta.

Ámbito requerido: write

Parámetro	Tipo	Descripción
`name`	Cadena	Nombre de la etiqueta
`type`	Cadena	`sources`, `channels` o `updates`
`description`	Cadena	Descripción del etiquetado de IA (opcional)

`update_tag`

Modifica el nombre o la descripción de una etiqueta.

Ámbito requerido: write

Parámetro	Tipo	Descripción
`tag_id`	Cadena	ID de la etiqueta
`name`	Cadena	Nuevo nombre (opcional)
`description`	Cadena	Nueva descripción de IA (opcional)

Temas relacionados

MCP — Cómo utilizar Picasi en el asistente de IA Contexto: qué es el MCP, los niveles de ámbito de OAuth y el concepto de seguridad.

Conectar Picasi con Claude Code Crear un token de API y configurarlo en Claude Code.

Conectar Picasi con Claude.ai Configurar la conexión OAuth para Claude.ai.