Partilhar via

Listas de SharePoint Ferramentas Referência de servidor MCP

Importante

É necessário fazer parte do programa de pré-visualização Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier liga-o diretamente às mais recentes inovações de IA da Microsoft. As pré-visualizações da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como estas funcionalidades ainda estão em desenvolvimento, a sua disponibilidade e capacidades podem mudar ao longo do tempo.

Descrição geral

ID do servidor Nome a apresentar Descrição
mcp_SharePointListsTools Microsoft SharePoint Lista Servidor MCP Servidor MCP que fornece ferramentas Microsoft Graph SharePoint para listas. Servidor MCP que fornece ferramentas Microsoft Graph SharePoint para listas.

Ferramentas disponíveis

sharepoint_createList

Crie uma nova lista de SharePoint num site.

Parâmetros Obrigatórios

  • siteId: O ID único do site
  • displayName: Nome de exibição da lista
  • lista: Informação da lista como modelo (por exemplo, genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Crie uma nova coluna (columnDefinition) numa lista específica do SharePoint. Deve fornecer o siteId e listId-alvo, além de uma definição de coluna válida que especifique o nome da coluna, o nome de exibição e exatamente um tipo de coluna (como texto, número, escolha, dataHora, pessoaOrGrupo, pesquisa, booleano ou hiperlinkOrImagem).

Parâmetros necessários

  • siteId: O ID único do site
  • listId: O ID único da lista
  • nome: API/nome estático da coluna (sem espaços, 1-64 caracteres)

Parâmetros opcionais

  • displayName: Nome de visualização voltado para utilizador
  • Descrição: Descrição da coluna
  • enforceUniqueValues: Se for verdadeiro, os valores devem ser únicos
  • hidden: Se for verdadeiro, a coluna está oculta
  • indexado: Se for verdadeiro, os valores são indexados
  • exigido: Se for verdadeiro, é necessário um valor
  • readOnly: Se for verdadeiro, os valores não podem ser alterados
  • texto, número, escolha, booleano, dataHora, pessoaOuGroup, pesquisa, hiperligaçãoOuImagem: Definições de tipo de coluna (uma necessária)

sharepoint_createListItem

Crie um novo item numa lista do SharePoint.

Parâmetros necessários

  • siteId: O ID único do site
  • listId: O ID único da lista
  • campos: Valores de campo para o item da lista (mapa chave/valor)

sharepoint_deleteListColumn

Apague uma Definição de coluna existente de uma lista específica do SharePoint. Fornecer siteId, listID e columnId. Esta ação remove permanentemente a coluna do esquema da lista.

Parâmetros necessários

  • SiteId: ID único do site
  • listId: ID único da lista
  • columnId: ID único da coluna a eliminar

sharepoint_deleteListItem

Eliminar um item de lista.

Parâmetros necessários

  • siteId: O ID único do site
  • listId: O ID único da lista
  • Id do item: O ID único do item da lista

Parâmetros opcionais

  • ifMatch: ETag opcional para controlo de concorrência (por exemplo, "*")

sharepoint_editListColumn

Atualize uma Definição de coluna existente numa lista específica do SharePoint. Fornecer siteId, listID e columnId. O corpo é parcial – inclua apenas as propriedades que quer alterar (como displayName, descrição, oculto, obrigatório ou definições de facet).

Parâmetros necessários

  • SiteId: ID único do site
  • listId: ID único da lista
  • columnId: ID único da coluna a atualizar

Parâmetros opcionais

  • displayName: Nome de visualização voltado para utilizador
  • Descrição: Descrição da coluna
  • hidden: Se for verdadeiro, a coluna está oculta
  • exigido: Se for verdadeiro, é necessário um valor
  • enforceUniqueValues: Se for verdadeiro, os valores devem ser únicos
  • indexado: Se for verdadeiro, os valores são indexados
  • readOnly: Se for verdadeiro, os valores não podem ser alterados
  • texto, número, escolha, dataHora, pessoaOuGroup, pesquisa, hiperligaçãoOuImagem: Atualizar definições de tipo de coluna

sharepoint_getSiteByPath

Resolve um site SharePoint usando o seu nome de host e o caminho relativo ao servidor.

Parâmetros necessários

  • Nome do host: Nome do host do tenant SharePoint (por exemplo, contoso.sharepoint.com)
  • serverRelativePath: Caminho relativo ao servidor para o site (por exemplo, sites/Marketing)

sharepoint_listListColumns

Lista de definições de colunas (columnDefinition resources) para uma lista específica do SharePoint. Requer siteId e listId. Suporta parâmetros OData como $select, $top e $skiptoken.

Parâmetros necessários

  • siteId: O ID único do site
  • listId: O ID único da lista

Parâmetros opcionais

  • select: lista separada por vírgulas de propriedades a devolver
  • filtro: Expressão do filtro OData para restringir resultados
  • orderBy: Lista separada por vírgulas de propriedades a ordenar por
  • topo: Tamanho da página (1-999)
  • skiptoken: Token opaco para paginação para o conjunto seguinte

sharepoint_listListItems

Lista itens a partir de uma lista do SharePoint.

Parâmetros necessários

  • siteId: O ID único do site
  • listId: O ID único da lista

Parâmetros opcionais

  • expandir: Opcional OData expandir (por exemplo, campos)
  • topo: Tamanho opcional da página
  • filtro: Expressão opcional do filtro OData
  • select: Opcional cláusula OData select

sharepoint_listLists

Liste todas as listas SharePoint num site.

Parâmetros necessários

  • siteId: O ID único do site

sharepoint_listSubsites

Liste sites filhos (subsites) para um dado site.

Parâmetros necessários

  • siteId: O ID único do site

Pesquise SharePoint usando a Microsoft Graph Search API com entityTypes=["site"].

Parâmetros necessários

  • pedidos: Array de objetos searchRequest

Parâmetros opcionais

  • entityTypes: Deve ser ["site"] para pesquisas de sites SharePoint
  • consulta: Consulta a objeto com cadeia de pesquisa ao estilo KQL
  • de: Deslocamento base zero do primeiro resultado
  • Tamanho: Número de resultados a devolver (1-50)
  • campos: Lista opcional de campos a selecionar na resposta

13. sharepoint_searchSitesByName

Pesquise sites SharePoint por nome de exibição ou URL parcial (língua natural).

Parâmetros necessários

  • pesquisa: Nome de exibição ou nome/URL parcial do site SharePoint a procurar

Parâmetros opcionais

  • consistencyLevel: Exigido pelo Microsoft Graph (padrão: eventual)

14. sharepoint_updateListItem

Atualize os campos de um item da lista existente.

Parâmetros necessários

  • siteId: O ID único do site
  • listId: O ID único da lista
  • Id do item: O ID único do item da lista
  • campos: Valores de campo a atualizar (parcial)

Parâmetros opcionais

  • ifMatch: ETag opcional para controlo de concorrência (por exemplo, "*" para forçar)

Funcionalidades principais

Gestão de Listas

  • Criar novas listas SharePoint com modelos
  • Liste todas as listas num site
  • Suporte para vários modelos de listas (genericList, documentLibrary, issueTracking)

Coluna C – Operações

  • Criar colunas com múltiplos tipos de dados (texto, número, escolha, dataHora, pessoaOrGroup, pesquisa, booleano, hiperlinkOrImagem)
  • Editar colunas existentes
  • Eliminar colunas
  • Liste todas as colunas de uma lista
  • Validação de colunas e restrições de unicidade

Operações da equipa

  • Criar itens de lista com valores de campo
  • Atualizar itens de lista existentes (atualizações parciais)
  • Eliminar um item de lista.
  • Itens da lista com filtragem e paginação
  • Controlo de concorrência via ETag

Descoberta do Sítio

  • Pesquise sites por nome ou URL
  • Resolver sites por nome de host e caminho
  • Subsites da lista
  • Pesquisa ao estilo KQL com API Microsoft Graph Search

Suporte de Consultas OData

  • Use $select para escolher propriedades.
  • Use $filter para filtrar resultados.
  • Use $expand para incluir entidades relacionadas.
  • Usa $orderby para ordenar resultados.
  • Usa $top para paginação.
  • Usa $skiptoken para folhear grandes conjuntos de resultados.

Suporte de Tipos de Coluna

  • Colunas de texto (linha simples ou multilinha, texto simples ou enriquecido).
  • Colunas numéricas (com casas decimais, valores mínimos e máximos).
  • Colunas de escolha (caixas de seleção, menu suspenso ou botões de acesso).
  • Colunas booleanas.
  • Data Hora, Data e Hora, Apenas Data
  • Colunas de Pessoa ou Grupo (seleção única ou múltipla).
  • Consulta colunas (consulta outras listas).
  • Colunas de hiperligação ou imagem.

Notas

  1. Todas as operações utilizam a Microsoft Graph API v1.0.
  2. Os nomes das colunas devem ter de 1 a 64 caracteres sem espaços.
  3. Cada coluna deve especificar exatamente um tipo de coluna.
  4. O controlo de concorrência está disponível através do If-Match cabeçalho.
  5. As pesquisas no site exigem consistencyLevel definir para eventual.
  6. Os resultados de pesquisa estão limitados a 50 itens por página.
  7. São suportadas atualizações parciais para colunas e itens de lista.
  • Last updated on