SharePoint MCP Server

Integração com Microsoft Graph API via Model Context Protocol
Versão 1.0 • Node.js • MCP (stdio / SSE)

📌 Visão Geral

Este projeto implementa um servidor MCP (Model Context Protocol) que permite ao Claude acessar dados do SharePoint Online através da Microsoft Graph API.

Arquitetura: Claude ↔ MCP Server (Node.js) ↔ Microsoft Graph API ↔ SharePoint Lists

Related MCP server: SharePoint MCP Server

⚙️ Pré-requisitos

Software

• Node.js (versão 18+)

• npm

• Claude Desktop

🔐 Azure AD — App Registration

Permissões necessárias:

• Sites.Read.All

• Lists.Read ou Lists.ReadWrite

Após configurar, conceder admin consent.

🚀 Instalação

mkdir F:\PROJECTS\C-Sharepoint-MCP
cd F:\PROJECTS\C-Sharepoint-MCP
npm init -y
npm install @modelcontextprotocol/sdk @azure/msal-node

📁 Estrutura

C-Sharepoint-MCP/
├── index.mjs
├── package.json
└── node_modules/

💻 Código index.mjs

// (código omitido para simplificação — usar versão completa)

🧰 Ferramentas

• list_sites

• list_sharepoint_lists

• get_list_items

⚙️ Configuração Claude

Arquivo:

Windows: %APPDATA%\Claude\claude_desktop_config.json

Exemplo:

{
  "mcpServers": {
    "sharepoint": {
      "command": "node",
      "args": ["F:\\PROJECTS\\C-Sharepoint-MCP\\index.mjs"]
    }
  }
}

🛠️ Diagnóstico

node F:\PROJECTS\C-Sharepoint-MCP\index.mjs

⚠️ Erros comuns

• 401 → credenciais erradas

• 403 → sem admin consent

• 404 → siteId errado

✅ Checklist

• Credenciais OK

• Permissões OK

• Node instalado

• npm install executado

• Claude reiniciado

🚀 Próximos passos

• Deploy em Azure

• Expandir ferramentas Graph API

Projeto: C-Sharepoint-MCP