Model Context Protocol (MCP) Server for Graphlit Platform

Graphlit Platform 用 Model Context Protocol（MCP）サーバー

概要

Model Context Protocol（MCP）サーバーを使用すると、MCP クライアントと Graphlit サービスを連携できます。このドキュメントでは、セットアップ手順とクライアントの基本的な使用例を説明します。

Slack、Discord、Web サイト、Google Drive、メール、Jira、Linear、GitHub から任意のデータを Graphlit プロジェクトに取り込み、Cursor、Windsurf、Goose、Cline などの MCP クライアント内で、関連するナレッジを検索・取得できます。

Graphlit プロジェクトは、開発およびプロダクト管理ツール全体にわたる、検索可能で RAG に対応したナレッジベースとして機能します。

ドキュメント（PDF、DOCX、PPTX など）と HTML ウェブページは、取り込み時に Markdown に抽出されます。音声ファイルと動画ファイルは、取り込み時に文字起こしされます。

ウェブクロールとウェブ検索は MCP ツールとして組み込まれているため、Firecrawl や Exa などのツールを別途連携する必要はありません。

MCP サーバーのユースケースと機能については、ブログをご覧ください。

Goose MCP クライアントで Graphlit MCP サーバーを使用する方法について、最新のYouTube 動画をご覧ください。

MCP サーバーの使用に関するご質問は、Discord コミュニティに参加し、#mcp チャンネルに投稿してください。

ツール

検索・取得

• コンテンツのクエリ
• コレクションのクエリ
• フィードのクエリ
• 会話のクエリ
• 関連するソースの取得
• 類似画像の取得
• 画像の視覚的な説明

RAG

• LLM 会話へのプロンプト

抽出

• テキストからの構造化 JSON の抽出

公開

• 音声として公開（ElevenLabs Audio）
• 画像として公開（OpenAI Image Generation）

取り込み

• ファイル
• ウェブページ
• メッセージ
• 投稿
• メール
• 課題
• テキスト
• メモリ（短期）

データコネクター

• Microsoft Outlook メール
• Google Mail
• Notion
• Reddit
• Linear
• Jira
• GitHub Issues
• Google Drive
• OneDrive
• SharePoint
• Dropbox
• Box
• GitHub
• Slack
• Microsoft Teams
• Discord
• Twitter/X
• ポッドキャスト（RSS）

ウェブ

• ウェブクロール
• ウェブ検索（ポッドキャスト検索を含む）
• ウェブマッピング
• ページのスクリーンショット

通知

• Slack
• メール
• Webhook
• Twitter/X

操作

• プロジェクトの設定
• コレクションの作成
• コンテンツのコレクションへの追加
• コレクションからのコンテンツの削除
• コレクションの削除
• フィードの削除
• コンテンツの削除
• 会話の削除
• フィードの処理完了確認
• コンテンツの処理完了確認

列挙

• Slack チャンネルの一覧表示
• Microsoft Teams チームの一覧表示
• Microsoft Teams チャンネルの一覧表示
• SharePoint ライブラリの一覧表示
• SharePoint フォルダーの一覧表示
• Linear プロジェクトの一覧表示
• Notion データベースの一覧表示
• Notion ページの一覧表示
• Dropbox フォルダーの一覧表示
• Box フォルダーの一覧表示
• Discord ギルドの一覧表示
• Discord チャンネルの一覧表示
• Google カレンダーの一覧表示
• Microsoft カレンダーの一覧表示

リソース

• プロジェクト
• コンテンツ
• フィード
• コレクション（コンテンツ）
• ワークフロー
• 会話
• 仕様

前提条件

開始する前に、以下を用意してください。

• システムに Node.js がインストールされていること（推奨バージョンは 18.x 以降です）。
• Graphlit Platform の有効なアカウントがあり、API 設定ダッシュボードにアクセスできること。

設定

Graphlit MCP Server では、認証と設定に使用する環境変数を設定できます。

• GRAPHLIT_ENVIRONMENT_ID：環境 ID です。
• GRAPHLIT_ORGANIZATION_ID：組織 ID です。
• GRAPHLIT_JWT_SECRET：JWT トークンの署名に使用する JWT シークレットです。

これらの値は、Graphlit Platform の API 設定ダッシュボードで確認できます。

インストール

VS Code 経由でのインストール

すばやくインストールするには、以下のワンクリックインストールボタンのいずれかを使用してください。

手動でインストールするには、以下の JSON ブロックを VS Code のユーザー設定（JSON）ファイルに追加してください。Ctrl + Shift + P を押して Preferences: Open User Settings (JSON) と入力すると、ファイルを開けます。

任意で、ワークスペース内の .vscode/mcp.json というファイルに追加することもできます。これにより、設定をほかのユーザーと共有できます。

.vscode/mcp.json ファイルでは、mcp キーは不要です。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "organization_id",
        "description": "Graphlit Organization ID",
        "password": true
      },
      {
        "type": "promptString",
        "id": "environment_id",
        "description": "Graphlit Environment ID",
        "password": true
      },
      {
        "type": "promptString",
        "id": "jwt_secret",
        "description": "Graphlit JWT Secret",
        "password": true
      }
    ],
    "servers": {
      "graphlit": {
        "command": "npx",
        "args": ["-y", "graphlit-mcp-server"],
        "env": {
          "GRAPHLIT_ORGANIZATION_ID": "${input:organization_id}",
          "GRAPHLIT_ENVIRONMENT_ID": "${input:environment_id}",
          "GRAPHLIT_JWT_SECRET": "${input:jwt_secret}"
        }
      }
    }
  }
}

Windsurf 経由でのインストール

Windsurf IDE アプリケーションに graphlit-mcp-server をインストールするには、Cline で NPX を使用します。

npx -y graphlit-mcp-server

mcp_config.json ファイルは、次のように設定してください。

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
            }
        }
    }
}

Cline 経由でのインストール

Cline IDE アプリケーションに graphlit-mcp-server をインストールするには、Cline で NPX を使用します。

npx -y graphlit-mcp-server

cline_mcp_settings.json ファイルは、次のように設定してください。

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
            }
        }
    }
}

Cursor 経由でのインストール

Cursor IDE アプリケーションに graphlit-mcp-server をインストールするには、Cursor で NPX を使用します。

npx -y graphlit-mcp-server

mcp.json ファイルは、次のように設定してください。

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
            }
        }
    }
}

Smithery 経由でのインストール

Smithery 経由で、Claude Desktop 用の graphlit-mcp-server を自動的にインストールするには、次の手順を実行します。

npx -y @smithery/cli install @graphlit/graphlit-mcp-server --client claude

手動でのインストール

Graphlit MCP Serverを任意のMCPクライアントアプリケーションで使用するには、次のコマンドを実行します。

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
            }
        }
    }
}

必要に応じて、Slack、Google Email、Notionなどのデータコネクターの認証情報を設定できます。 必須なのはGRAPHLIT_ORGANIZATION_ID、GRAPHLIT_ENVIRONMENT_ID、GRAPHLIT_JWT_SECRETのみです。

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
                "SLACK_BOT_TOKEN": "your-slack-bot-token",
                "DISCORD_BOT_TOKEN": "your-discord-bot-token",
                "TWITTER_TOKEN": "your-twitter-token",
                "GOOGLE_EMAIL_REFRESH_TOKEN": "your-google-refresh-token",
                "GOOGLE_EMAIL_CLIENT_ID": "your-google-client-id",
                "GOOGLE_EMAIL_CLIENT_SECRET": "your-google-client-secret",
                "LINEAR_API_KEY": "your-linear-api-key",
                "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-pat",
                "JIRA_EMAIL": "your-jira-email",
                "JIRA_TOKEN": "your-jira-token",
                "NOTION_API_KEY": "your-notion-api-key"
            }
        }
    }
}

注：Windowsで「npx」を実行する場合、コマンドプロンプトからnpxを明示的に呼び出す必要があることがあります。

"command": "C:\\Windows\\System32\\cmd.exe /c npx"

サポート

Graphlit API Documentationをご覧ください。

Graphlit MCP Serverのサポートについては、GitHub Issueを送信してください。

Graphlit Platformについてさらにサポートが必要な場合は、Discordコミュニティにご参加ください。