MCP-Tools - Visión general
Derechos de acceso
Las herramientas MCP se asignan a tres niveles de ámbito:
| Ámbito | Significado |
|---|---|
read | Solo acceso de lectura; sin posibilidad de crear, editar ni eliminar |
write | Lectura y escritura de fuentes, canales y bandeja de entrada; 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 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 requerido: read
| Parámetro | Tipo | Descripción |
|---|---|---|
query | Cadena | Término de búsqueda de texto completo (opcional) |
source_id | Cadena | Actualizaciones de una fuente determinada (opcional) |
tags | Matriz | Etiquetas de actualización por las que se filtra (opcional) |
folder | Cadena | inbox, saved o dropped (opcional) |
limit | Entero | Número de resultados (por defecto: 20, máximo: 100) |
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 |
|---|---|---|
active_only | Booleano | Devuelve solo fuentes activas (por defecto: true) |
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 (URL del sitio web y documentos de contexto).
Ámbito requerido: read
Sin parámetros.
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 los 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
Cambia 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
Cambia 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) |