Notion MCP – wsparcie Twojego second brain

Instalacja Notion MCP Server

Notion MCP Server możesz uruchomić przez npx albo przez Dockera.

Najpierw tworzysz integrację w Notion. Potem nadajesz jej dostęp do wybranych stron i dodajesz konfigurację MCP do swojego klienta.

Krok 1: utwórz integrację w Notion

Wejdź w ustawienia integracji Notion i utwórz nową integrację wewnętrzną. Możesz też wybrać istniejącą integrację.

Po utworzeniu integracji skopiuj jej sekret. Będzie potrzebny jako token dostępu do Notion.

Krok 2: ustaw uprawnienia integracji

W konfiguracji integracji możesz określić jej możliwości. Jeśli chcesz ograniczyć ryzyko, możesz nadać tylko dostęp do odczytu treści.

Następnie połącz integrację z konkretnymi stronami i bazami w Notion. Zrobisz to w ustawieniach dostępu integracji albo bezpośrednio na wybranej stronie.

Krok 3: dodaj konfigurację MCP przez npx

Najprostsza konfiguracja używa NOTION_TOKEN. To zalecany sposób przekazania tokena integracji.

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_****"
      }
    }
  }
}

Zamień ntn_**** na sekret swojej integracji Notion.

Konfiguracja przez OPENAPI_MCP_HEADERS

W bardziej zaawansowanych przypadkach możesz użyć zmiennej OPENAPI_MCP_HEADERS.

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2025-09-03\" }"
      }
    }
  }
}

Ta opcja pozwala przekazać nagłówki wymagane przez Notion API.

Instalacja przez Docker

Możesz też uruchomić serwer z oficjalnego obrazu Docker.

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "NOTION_TOKEN",
        "mcp/notion"
      ],
      "env": {
        "NOTION_TOKEN": "ntn_****"
      }
    }
  }
}

Docker może być wygodny, jeśli chcesz uruchamiać serwer w bardziej odseparowanym środowisku.

Instalacja w Zed

W Zed dodaj serwer do pliku settings.json.

{
  "context_servers": {
    "some-context-server": {
      "command": {
        "path": "npx",
        "args": ["-y", "@notionhq/notion-mcp-server"],
        "env": {
          "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2025-09-03\" }"
        }
      },
      "settings": {}
    }
  }
}

Instalacja w GitHub Copilot CLI

W GitHub Copilot CLI możesz dodać serwer interaktywnie.

/mcp add

Możesz też dodać konfigurację ręcznie w pliku ~/.copilot/mcp-config.json.

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_****"
      }
    }
  }
}

Tryb komunikacji stdio

Domyślnie serwer używa trybu stdio. To standardowy tryb dla klientów takich jak Claude Desktop.

npx @notionhq/notion-mcp-server

Możesz też wskazać ten tryb bezpośrednio.

npx @notionhq/notion-mcp-server --transport stdio

Tryb Streamable HTTP

Jeśli korzystasz z aplikacji webowej albo klienta wymagającego HTTP, możesz uruchomić serwer w trybie http.

npx @notionhq/notion-mcp-server --transport http

Domyślnie serwer działa na porcie 3000. Możesz ustawić własny port.

npx @notionhq/notion-mcp-server --transport http --port 8080

W trybie HTTP serwer wymaga uwierzytelniania tokenem Bearer.

npx @notionhq/notion-mcp-server --transport http --auth-token "your-secret-token"

Możesz też przekazać token przez zmienną środowiskową.

AUTH_TOKEN="your-secret-token" npx @notionhq/notion-mcp-server --transport http

Szybki test po instalacji

Po zapisaniu konfiguracji uruchom ponownie klienta MCP. Następnie poproś AI o proste działanie w Notion.

Dodaj stronę o tytule „Notion MCP” do strony „Development”.

Możesz też poprosić o pobranie treści konkretnej strony, jeśli znasz jej ID.

Pobierz treść strony 1a6b35e6e67f802fa7e1d27686f017f2.

Co sprawdzić, gdy coś nie działa?

1. Sprawdź, czy token integracji został poprawnie wklejony.
2. Sprawdź, czy integracja ma dostęp do właściwej strony lub bazy.
3. Upewnij się, że klient MCP został ponownie uruchomiony po zmianie konfiguracji.
4. Sprawdź, czy używasz aktualnych narzędzi opartych na data_source_id.