Confluence

🚀 Confluence MCP サーバ

FastMCP ベースのサーバで、Confluence REST API とのシームレスな統合を提供し、Confluence のスペース、ページ、コンテンツ検索機能へのプログラムによるアクセスを実現します。

✨ 主な機能

• スペース管理：Confluence スペースを一覧表示し、フィルタリングすることができます。
• ページ操作：ページの内容を検索および管理します。
• 検索機能：CQL（Confluence クエリ言語）検索を実行します。
• スペースナビゲーション：特定のスペース内のすべてのページを一覧表示します。
• 認証：API トークンに基づく安全なアクセスを提供します。

📦 インストール

Smithery を使用した自動インストール

Smithery を通じて、Claude Desktop 用に confluence-mcp-server を自動インストールします。

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

手動インストール

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/confluence-mcp.git
   cd confluence-mcp
   

2. 依存関係をインストールします。

   pip install -r requirements.txt
   

3. サーバを起動します。

   python server.py
   

📚 ドキュメント

設定

1. .env ファイルを作成し、以下の内容を追加します。

   CONFLUENCE_BASE_URL=your_confluence_url
   USERNAME=your_atlassian_email
   API_TOKEN=your_api_token
   

2. 環境変数の例：

   export CONFLUENCE_BASE_URL="https://yourcompany.atlassian.net/wiki"
   export USERNAME="user@example.com"
   export API_TOKEN="your_api_token_here"
   

使用ガイド

1. サーバを起動します。

   python server.py
   

2. API メソッドの例：
   • スペースの一覧を取得する：

     response = requests.get("http://localhost:5000/api/confluence/spaces")
     

   • 新しいページを作成する：

     data = {
         "title": "New Page",
         "parent_id": "12345"
     }
     response = requests.post("http://localhost:5000/api/confluence/pages", json=data)
     

統合

Claude Desktop の設定例：

{
    "server_url": "http://localhost:5000",
    "api_key": "your_api_key_here"
}

Cursor の設定例：

{
    "confluence_server": "https://yourcompany.atlassian.net/wiki",
    "username": "user@example.com",
    "api_token": "your_api_token_here"
}

エラー処理

一般的なエラーコードとその意味：

• 401：無効な API トークンまたは資格情報です。
• 403：権限が不足しています。
• 404：リソースが見つかりません。
• 429：レート制限を超えています。

トラブルシューティング

1. 接続問題：
   • CONFLUENCE_BASE_URL の形式を確認します。
   • ネットワークの接続性を確認します。
   • API トークンが有効であることを確認します。
2. 認証エラー：
   • USERNAME が Atlassian アカウントのメールアドレスと一致していることを確認します。
   • API_TOKEN が正しく貼り付けられていることを確認します。
   • .env ファイル内の特殊文字を確認します。
3. 権限問題：
   • ユーザーが必要な Confluence 権限を持っていることを確認します。
   • スペースおよびページへのアクセス権限を確認します。

サポート

問題の報告や機能リクエストは、リポジトリの問題トラッカーに問題を作成してください。

📄 ライセンス

MIT ライセンスです。完全な条項については、LICENSE ファイルを参照してください。