A
securityF
licenseA
qualityA high-performance MCP server that integrates Notion into AI workflows, enabling interaction with Notion pages, databases, and comments through a standardized protocol.
Last updated -
19
25
Notion MCP Server
Dieses Projekt implementiert einen MCP-Server für die Notion-API .
Installation
1. Integration in Notion einrichten:
Gehen Sie zu https://www.notion.so/profile/integrations und erstellen Sie eine neue interne Integration oder wählen Sie eine vorhandene aus.
Obwohl wir den Umfang der verfügbaren Notion-APIs einschränken (z. B. können Sie Datenbanken nicht über MCP löschen), besteht ein nicht zu vernachlässigendes Risiko für Arbeitsbereichsdaten, wenn diese LLMs ausgesetzt werden. Sicherheitsbewusste Benutzer sollten die Funktionen der Integration weiter konfigurieren.
Sie können beispielsweise ein schreibgeschütztes Integrationstoken erstellen, indem Sie auf der Registerkarte „Konfiguration“ nur den Zugriff „Inhalte lesen“ gewähren:
2. Inhalte mit Integration verknüpfen:
Stellen Sie sicher, dass relevante Seiten und Datenbanken mit Ihrer Integration verbunden sind.
Besuchen Sie dazu diese Seite, klicken Sie auf die drei Punkte und wählen Sie „Mit Integration verbinden“.
3. Hinzufügen der MCP-Konfiguration zu Ihrem Client:
Verwenden von npm:
Fügen Sie Folgendes zu Ihrer .cursor/mcp.json oder claude_desktop_config.json hinzu (MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json )
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
}
}
}
}
Docker verwenden:
Es gibt zwei Möglichkeiten, den MCP-Server mit Docker auszuführen:
Option 1: Verwenden des offiziellen Docker Hub-Image:
Fügen Sie Folgendes zu Ihrer .cursor/mcp.json oder claude_desktop_config.json hinzu:
{
"mcpServers": {
"notionApi": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e", "OPENAPI_MCP_HEADERS",
"mcp/notion"
],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
}
}
}
}
Dieser Ansatz:
Verwendet das offizielle Docker Hub-Image
Behandelt JSON-Escape über Umgebungsvariablen ordnungsgemäß
Bietet eine zuverlässigere Konfigurationsmethode
Option 2: Lokales Erstellen des Docker-Images:
Sie können das Docker-Image auch lokal erstellen und ausführen. Erstellen Sie zunächst das Docker-Image:
docker-compose build
Fügen Sie dann Folgendes zu Ihrer .cursor/mcp.json oder claude_desktop_config.json hinzu:
{
"mcpServers": {
"notionApi": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\"}",
"notion-mcp-server"
]
}
}
}
Vergessen Sie nicht ntn_**** durch Ihr Integrationsgeheimnis zu ersetzen. Sie finden es auf der Registerkarte „Integrationskonfiguration“:
Beispiele
Mit der folgenden Anleitung
Comment "Hello MCP" on page "Getting started"
Die KI plant zwei API-Aufrufe, v1/search und v1/comments , korrekt, um die Aufgabe zu erfüllen
In ähnlicher Weise führt die folgende Anweisung dazu, dass der übergeordneten Seite „Entwicklung“ eine neue Seite mit dem Namen „Notion MCP“ hinzugefügt wird.
Add a page titled "Notion MCP" to page "Development"
Sie können die Inhalts-ID auch direkt referenzieren
Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2
Entwicklung
Bauen
npm run build
Ausführen
npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server
Veröffentlichen
npm publish --access public
This server cannot be installed
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.Last updated -15545110MIT License
- AsecurityAlicenseAqualityAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.Last updated -74614MIT License
- AsecurityAlicenseAqualityNotion MCP Server is a MCP server implementation that enables AI assistants to interact with Notion's API.Last updated -13210138MIT License