Skip to content

README.md

Latest commit

 

History

History
126 lines (92 loc) · 3.5 KB

README.md

File metadata and controls

126 lines (92 loc) · 3.5 KB
Raw

💬 Discourse MCP Integration Guide for community.cesium.com

📖 Overview

Discourse MCP is an MCP (Model Context Protocol) server that exposes Discourse forum capabilities as tools and resources for AI assistants.

This guide documents how to connect it to the Cesium community forum at:

💡 Why use Discourse MCP for Cesium

It gives agents direct access to real forum content (topics, posts, tags, categories, and user context) instead of relying on stale snapshots. That helps with:

  • finding current community answers
  • checking prior discussions before posting
  • drafting/supporting moderator and community workflows

⚙️ Setup Instructions

VS Code Configuration (.vscode/mcp.json)

Read-only (recommended to start):

{
  "mcp": {
    "servers": {
      "discourse": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@discourse/mcp@latest", "--site", "https://community.cesium.com"]
      }
    }
  }
}

Writes enabled (admin API key example):

{
  "mcp": {
    "servers": {
      "discourse": {
        "type": "stdio",
        "command": "npx",
        "args": [
          "-y",
          "@discourse/mcp@latest",
          "--site",
          "https://community.cesium.com",
          "--allow_writes",
          "--read_only=false",
          "--auth_pairs",
          "[{\"site\":\"https://community.cesium.com\",\"api_key\":\"YOUR_DISCOURSE_API_KEY\",\"api_username\":\"system\"}]"
        ]
      }
    }
  }
}
Claude Code / Claude Desktop Configuration

Read-only:

claude mcp add discourse -- npx -y @discourse/mcp@latest --site https://community.cesium.com

Writes enabled (admin API key):

claude mcp add discourse -- npx -y @discourse/mcp@latest --site https://community.cesium.com --allow_writes --read_only=false --auth_pairs '[{"site":"https://community.cesium.com","api_key":"YOUR_DISCOURSE_API_KEY","api_username":"system"}]'

🔐 Authentication Notes

  • Read-only mode is default and safest for discovery/search workflows.
  • For writes, use --allow_writes --read_only=false and provide --auth_pairs for the selected site.
  • Supported auth modes in upstream server:
    • admin API key (api_key + api_username)
    • user API key (user_api_key + optional user_api_client_id)

🚀 Usage Examples

After startup, ask your assistant to:

  • "Search community.cesium.com for discussions about 3D Tiles metadata best practices."
  • "Read topic 12345 and summarize open questions from the thread."
  • "List categories and tags relevant to Cesium for Unreal troubleshooting."

If you do not pass --site, first call:

{ "site": "https://community.cesium.com" }

with the discourse_select_site tool.

🧰 Common Built-in Tools

Some commonly used built-ins:

  • discourse_search
  • discourse_read_topic
  • discourse_read_post
  • discourse_filter_topics
  • discourse_get_user

Write tools (for example discourse_create_post and discourse_create_topic) are only available when writes are explicitly enabled.

🔗 Resources