Skip to main content
Glama
README.md
# 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

---

## ⚙️ 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

```bash
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

```javascript
// (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:

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

---

## 🛠️ Diagnóstico

```bash
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