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.

Selección de Workspace

El servidor MCP está en https://picasi.app/mcp, sin Workspace en la dirección.

Identificación	Workspace
Token de API	fijo, el Workspace del token; no hace falta ningún parámetro
OAuth	todos los Workspaces de la cuenta; cada llamada necesita `workspace_id`

Con OAuth, list_workspaces devuelve los valores posibles. Sin workspace_id se rechaza la llamada.

Herramientas de lectura

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

`search_updates`

Busca en las Updates 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	Updates de una fuente concreta (opcional)
`tags`	Matriz	Etiquetas de Update 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 Update.

Ámbito requerido: read

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

`list_sources`

Enumera todas las fuentes del Workspace.

Á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.

A cada canal se añaden tres campos que conviene distinguir:

Campo	Significado
`monitoring_active`	El interruptor del canal: encendido o apagado. No es un estado de salud.
`state`	El estado de la recuperación: `healthy`, `degraded`, `broken`, `quarantined` o `paused`. Los canales de correo no se recuperan, sino que reciben; informan `receiving`, `stale` o `waiting`. `null` significa que todavía no hay recuperación asociada.
`last_checked`	El último intento de recuperación; en los canales de correo, el último mensaje recibido.

Para el diagnóstico completo de un canal concreto está get_channel_status.

`list_reports`

Enumera los informes 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 Workspace: 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 Workspace.

Ámbito requerido: read

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

`get_update_statistics`

Cuenta Updates en lugar de enumerarlos. Admite los mismos filtros que search_updates y no tiene el tope de 100 resultados.

Ámbito necesario: read

Parámetro	Tipo	Descripción
`group_by`	Cadena	`source` (estándar), `source_tag`, `update_tag`, `day`, `week`, `month`, `quarter`
`compare_previous_period`	Booleano	Cuenta además el periodo anterior de la misma duración e indica la diferencia
`query`	Cadena	Término de búsqueda de texto completo (opcional)
`source_id`	Cadena	Limitar a una fuente (opcional)
`source_tags`	Matriz	Etiquetas de fuente (opcional)
`update_tags`	Matriz	Etiquetas temáticas (opcional)
`source_ownership`	Cadena	`all` (estándar), `own` o `competitor`
`platform`	Cadena	Limitar a una plataforma, p. ej. `linkedin` (opcional)
`folder`	Matriz	`inbox`, `saved`; de forma estándar, ambos
`days`	Entero	Periodo en días, de 1 a 365 (estándar: 30)
`date_from`, `date_to`	Cadena	Periodo como fecha, en lugar de `days`

No es posible agrupar por plataforma. Los Updates descartados y los del Overflow no se cuentan.

`get_channel_status`

Devuelve el estado de un canal: última recuperación, último éxito, último error, número de fallos consecutivos, próximo intento previsto y número de Updates de ese canal.

Ámbito necesario: read

Parámetro	Tipo	Descripción
`channel_id`	Cadena	ID del canal, de `list_sources` con `include_channels=true`

`discover_channels`

Examina un sitio web e informa de los canales que se podrían observar. No crea nada.

Ámbito necesario: read

Parámetro	Tipo	Descripción
`url`	Cadena	Sitio web que se va a examinar (opcional si `source_id` está definido)
`source_id`	Cadena	Usa el sitio web de esta fuente y marca los canales que ya tiene

`list_workspaces`

Enumera los Workspaces de la cuenta identificada con workspace_id, nombre y rol.

Ámbito necesario: ninguno; la herramienta está abierta a cualquier conexión

Sin parámetros.

Herramientas de informes

`create_report`

Crea un informe a partir de los Updates que coinciden con un filtro. Los filtros son los mismos que en search_updates.

La generación se ejecuta en segundo plano: la llamada devuelve de inmediato un request_id. get_report_status indica en qué punto está y get_report lee el informe terminado.

Ámbito necesario: read

Parámetro	Tipo	Descripción
`type`	Cadena	Obligatorio. `summary`, `feedback`, `list` o `conversation_starters`
`title`	Cadena	Nombre del informe (opcional)
`instructions`	Cadena	Enfoque para la IA (opcional)
`language`	Cadena	Código de idioma, p. ej. `de`; de forma estándar, el idioma del Workspace
`query`	Cadena	Término de búsqueda de texto completo (opcional)
`source_ids`	Matriz	Limitar a estas fuentes (opcional)
`source_tags`	Matriz	Etiquetas de fuente (opcional)
`source_tags_mode`	Cadena	`AND` u `OR`
`update_tags`	Matriz	Etiquetas temáticas (opcional)
`update_tags_mode`	Cadena	`AND` u `OR`
`source_ownership`	Cadena	`all`, `own` o `competitor`
`platform`	Cadena	Limitar a una plataforma (opcional)
`folder`	Matriz	Carpetas de la base de datos; de forma estándar, `inbox` y `saved`
`days`	Entero	Periodo en días, de 1 a 365 (estándar: 30)
`date_from`, `date_to`	Cadena	Periodo como fecha, en lugar de `days`

`get_report_status`

Devuelve el estado de un informe encargado con create_report.

Ámbito necesario: read

Parámetro	Tipo	Descripción
`request_id`	Cadena	El `request_id` de `create_report`

Estado	Significado
`queued`	en espera en la cola
`running`	se está generando
`ready`	terminado; léelo con `get_report` y el `report_id`
`empty`	terminado, pero ningún Update coincidía con los filtros
`failed`	interrumpido; el motivo está en la respuesta

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 Updates.

Á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)

`update_update_state`

Mueve Updates entre las carpetas del Workspace.

Ámbito necesario: write

Parámetro	Tipo	Descripción
`update_ids`	Matriz	IDs de Updates, como máximo 100 por llamada
`folder`	Cadena	`inbox`, `saved` o `dropped`

El estado vale por Workspace y no modifica el Update en sí. La respuesta informa de cada ID por separado.

`tag_update`

Asigna a los Updates etiquetas temáticas ya existentes.

Ámbito necesario: write

Parámetro	Tipo	Descripción
`update_ids`	Matriz	IDs de Updates, como máximo 100 por llamada
`tags`	Matriz	Etiquetas como slug, ID o nombre
`mode`	Cadena	`add` (estándar) conserva las etiquetas existentes, `replace` deja exactamente estas

Solo se admiten etiquetas con applies_to = updates; una etiqueta de fuente se rechaza. Crea antes las etiquetas que falten con create_tag.

`untag_update`

Quita etiquetas temáticas de los Updates.

Ámbito necesario: write

Parámetro	Tipo	Descripción
`update_ids`	Matriz	IDs de Updates, como máximo 100 por llamada
`tags`	Matriz	Etiquetas que se van a quitar, como slug, ID o nombre

Solo se quita la asignación de este Workspace. La etiqueta en sí se mantiene.

`refresh_source_channels`

Vuelve a ejecutar la detección de canales para una fuente existente.

Ámbito necesario: write

Parámetro	Tipo	Descripción
`source_id`	Cadena	ID de la fuente
`create_detected`	Booleano	`false` (estándar) solo informa, `true` crea los canales que faltan

Los canales existentes no se crean por duplicado; un canal desactivado cuenta como existente. Los canales nuevos empiezan a recuperar por sí solos.

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.