Ferramentas MCP — Visão geral

Direitos de acesso

As ferramentas MCP estão atribuídas a três níveis de scope:

Scope	Significado
`read`	Acesso apenas de leitura; sem criação, edição ou eliminação
`write`	Leitura e escrita de fontes, canais e Inbox; sem acesso às definições da equipa
`admin`	Acesso total ao MCP, incluindo as definições da equipa

Nas ligações OAuth, o scope escolhido durante a autorização limita as ferramentas que podem ser chamadas. Nos tokens de API, o papel do token define o nível máximo de acesso.

Ferramentas de leitura

Todas as ferramentas de leitura exigem, no mínimo, o scope read.

`search_updates`

Pesquisa Updates por termos de pesquisa, fontes, tags e período.

Scope necessário: read

Parâmetro	Tipo	Descrição
`query`	String	Termo de pesquisa de texto completo (opcional)
`source_id`	String	Updates de uma fonte específica (opcional)
`tags`	Array	Tags de Update pelos quais se filtra (opcional)
`folder`	String	`inbox`, `saved` ou `dropped` (opcional)
`source_ownership`	String	`all` (padrão), `own` (apenas fontes próprias) ou `competitor` (apenas fontes externas)
`limit`	Integer	Número de resultados (padrão: 20, máximo: 100)

O filtro source_ownership utiliza o campo is_own da fonte. É o equivalente ao filtro Ownership na UI da Inbox e permite que o assistente de IA analise especificamente apenas a própria presença ou apenas os concorrentes.

`get_update_details`

Devolve o conteúdo completo de um único Update.

Scope necessário: read

Parâmetro	Tipo	Descrição
`update_id`	String	ID do Update

`list_sources`

Enumera todas as fontes do Workspace.

Scope necessário: read

Parâmetro	Tipo	Descrição
`is_own`	Boolean	`true` = apenas fontes próprias, `false` = apenas concorrentes, omitir = todas

Cada fonte devolvida contém o campo is_own, para que os assistentes de IA possam separar a própria presença dos concorrentes sem terem de fazer um segundo pedido.

`list_reports`

Enumera os relatórios de IA disponíveis.

Scope necessário: read

Parâmetro	Tipo	Descrição
`type`	String	`summary`, `feedback`, `list`, `linkedin_post`, `conversation_starters` (opcional)
`limit`	Integer	Número (padrão: 10)

`get_report`

Devolve o conteúdo completo de um relatório.

Scope necessário: read

Parâmetro	Tipo	Descrição
`report_id`	String	ID do relatório

`get_team_context`

Devolve o contexto de IA do Workspace: metadados da equipa (nome, idioma, fuso horário), URL do site, documentos de contexto e a configuração de Ownership.

Scope necessário: read

Sem parâmetros obrigatórios.

A resposta contém, no bloco context:

website_url — URL da organização registada
is_own_sources_configured — true assim que pelo menos uma fonte estiver marcada como própria
own_sources_count — número de fontes próprias

Os assistentes de IA só devem propor comparações de voice-share ou momentum quando is_own_sources_configured for true — caso contrário, falta a base de comparação.

`list_tags`

Enumera todos os tags do Workspace.

Scope necessário: read

Parâmetro	Tipo	Descrição
`type`	String	`sources`, `channels`, `updates` (opcional)

Ferramentas de escrita

Todas as ferramentas de escrita exigem, no mínimo, o scope write.

`create_source`

Cria uma nova fonte.

Scope necessário: write

Parâmetro	Tipo	Descrição
`url`	String	URL do site da fonte
`name`	String	Nome interno
`tags`	Array	IDs de tags (opcional)

`update_source`

Altera o nome, o URL ou os tags de uma fonte existente.

Scope necessário: write

Parâmetro	Tipo	Descrição
`source_id`	String	ID da fonte
`name`	String	Novo nome (opcional)
`url`	String	Novo URL (opcional)

`delete_source`

Elimina uma fonte, incluindo todos os canais e Updates.

Scope necessário: write

Parâmetro	Tipo	Descrição
`source_id`	String	ID da fonte

`create_channel`

Cria um canal manualmente.

Scope necessário: write

Parâmetro	Tipo	Descrição
`source_id`	String	ID da fonte superior
`url`	String	URL do canal
`name`	String	Nome do canal (opcional)

`update_channel`

Altera o nome ou a descrição de um canal.

Scope necessário: write

Parâmetro	Tipo	Descrição
`channel_id`	String	ID do canal
`name`	String	Novo nome (opcional)

`delete_channel`

Elimina um canal.

Scope necessário: write

Parâmetro	Tipo	Descrição
`channel_id`	String	ID do canal

`toggle_channel`

Ativa ou desativa um canal.

Scope necessário: write

Parâmetro	Tipo	Descrição
`channel_id`	String	ID do canal
`active`	Boolean	`true` = ativo, `false` = inativo

`create_tag`

Cria um novo tag.

Scope necessário: write

Parâmetro	Tipo	Descrição
`name`	String	Nome do tag
`type`	String	`sources`, `channels` ou `updates`
`description`	String	Descrição para o KI-Tagging (opcional)

`update_tag`

Altera o nome ou a descrição de um tag.

Scope necessário: write

Parâmetro	Tipo	Descrição
`tag_id`	String	ID do tag
`name`	String	Novo nome (opcional)
`description`	String	Nova descrição de IA (opcional)

Tópicos relacionados

MCP — Usar o Picasi no assistente de IA Contexto: o que é o MCP, níveis de scope OAuth e conceito de segurança.

Ligar o Picasi ao Claude Code Criar API-Token e configurá-lo no Claude Code.

Ligar o Picasi ao Claude.ai Configurar a ligação OAuth para o Claude.ai.