Automação do SharePoint

Automatize operações do SharePoint, incluindo o gerenciamento de sites, listas, documentos, pastas e páginas. Integra-se com a API REST do SharePoint e o Microsoft Graph via OneDrive.

Documentação do Toolkit: composio.dev/toolkits/share_point

Configuração

Esta habilidade requer o servidor Rube MCP conectado em https://rube.app/mcp.

Antes de executar qualquer ferramenta, certifique-se de que existem conexões ativas para os toolkits share_point e one_drive. Se nenhuma conexão estiver ativa, inicie uma através de RUBE_MANAGE_CONNECTIONS.

Observação: Muitas ferramentas do OneDrive/SharePoint funcionam apenas com contas corporativas do Microsoft 365 (Azure AD/Entra ID). Contas pessoais da Microsoft NÃO são suportadas.

Fluxos de Trabalho Principais

1. Listar e Navegar por Sites

Recupere detalhes de sites e enumere subsites para descobrir a topologia do SharePoint.

Ferramentas:

• ONE_DRIVE_GET_SITE_DETAILS -- Obter metadados de um site específico por ID
• ONE_DRIVE_LIST_SITE_SUBSITES -- Listar todos os subsites de um site pai

Parâmetros Principais:

• site_id (obrigatório) -- Formato composto: hostname,site-collection-guid,web-guid (ex: "contoso.sharepoint.com,da60e844-...,712a596e-...")

Exemplo:

Tool: ONE_DRIVE_GET_SITE_DETAILS
Arguments:
  site_id: "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"

2. Gerenciar Listas

Crie listas, enumere listas existentes e recupere itens de listas.

Ferramentas:

• SHARE_POINT_LIST_ALL_LISTS -- Recuperar todas as listas em um site (suporta filtro OData, select, orderby, top)
• SHARE_POINT_SHAREPOINT_CREATE_LIST -- Criar uma nova lista com um template especificado
• ONE_DRIVE_LIST_SITE_LISTS -- Listar todas as listas sob um site via Microsoft Graph
• ONE_DRIVE_GET_SHAREPOINT_LIST_ITEMS -- Recuperar itens de uma lista específica

Parâmetros Principais para SHARE_POINT_SHAREPOINT_CREATE_LIST:

• name (obrigatório) -- Nome da lista
• template (obrigatório) -- Tipo de template: "genericList", "documentLibrary", "tasks", etc.
• description -- Descrição opcional

Parâmetros Principais para SHARE_POINT_LIST_ALL_LISTS:

• filter -- Filtro OData, ex: "Hidden eq false"
• select -- Propriedades a serem retornadas, ex: "Title,Id"
• orderby -- Expressão de ordenação, ex: "Title desc"
• top -- Limitar a contagem de resultados

Exemplo:

Tool: SHARE_POINT_SHAREPOINT_CREATE_LIST
Arguments:
  name: "Project Tasks"
  template: "tasks"
  description: "Task tracking for Q1 deliverables"

3. Gerenciar Pastas e Arquivos

Crie pastas, liste arquivos dentro de pastas e navegue pela biblioteca de documentos.

Ferramentas:

• SHARE_POINT_SHAREPOINT_CREATE_FOLDER -- Criar uma nova pasta em uma biblioteca de documentos
• SHARE_POINT_LIST_FILES_IN_FOLDER -- Listar arquivos dentro de uma pasta por URL relativo ao servidor
• SHARE_POINT_GET_FOLDER_BY_SERVER_RELATIVE_URL -- Obter metadados de pasta por caminho

Parâmetros Principais para SHARE_POINT_SHAREPOINT_CREATE_FOLDER:

• folder_name (obrigatório) -- Nome da pasta a ser criada
• document_library -- Biblioteca de destino (padrão: "Shared Documents")
• relative_path -- Caminho adicional dentro da biblioteca

Parâmetros Principais para SHARE_POINT_LIST_FILES_IN_FOLDER:

• folder_name (obrigatório) -- URL relativo ao servidor, ex: "/Shared Documents"
• select -- Propriedades separadas por vírgula, ex: "Name,ServerRelativeUrl,Length"
• top -- Limitar a contagem de resultados
• orderby -- Expressão de ordenação, ex: "Name desc"

Exemplo:

Tool: SHARE_POINT_LIST_FILES_IN_FOLDER
Arguments:
  folder_name: "/Shared Documents/Reports"
  select: "Name,ServerRelativeUrl,Length"
  top: 50

4. Pesquisar Conteúdo do SharePoint

Use a Linguagem de Consulta de Palavras-chave (KQL) para pesquisar documentos, itens de lista e outros conteúdos em todo o site.

Ferramenta: SHARE_POINT_SEARCH_QUERY

Parâmetros Principais:

• querytext (obrigatório) -- Consulta KQL, ex: "project report", "FileType:docx", "Author:\"John Doe\""
• rowlimit -- Máximo de resultados por solicitação (padrão ~50, máximo 500)
• startrow -- Deslocamento baseado em zero para paginação
• selectproperties -- Propriedades a serem retornadas, ex: "Title,Author,Path"
• refinementfilters -- Restringir resultados, ex: "FileType:equals(\"docx\")"

Exemplo:

Tool: SHARE_POINT_SEARCH_QUERY
Arguments:
  querytext: "IsDocument:1 FileType:pdf"
  rowlimit: 25
  selectproperties: "Title,Author,Path,LastModifiedTime"

5. Rastrear Alterações de Lista (Delta Query)

Use consultas delta para obter alterações incrementais (itens criados, atualizados, excluídos) sem ler a lista inteira.

…