@esaio/esa-mcp-server

What it does

Connects Claude and other MCP clients to esa.io, an information-sharing platform for team knowledge management. The server exposes esa's REST API through MCP tools, enabling Claude to search posts by keyword or tag, retrieve post content and metadata, create or update articles, manage comments, organize category hierarchies, and handle file attachments. It supports marking posts as "shipped" (published from draft), archiving, and duplicating posts across teams. The server also includes utilities for retrieving team statistics, member lists, tag inventories, and esa's own documentation on search syntax and Markdown formatting.

Who it's for

Teams and individuals using esa.io for documentation, knowledge bases, or collaborative writing who want AI assistance with content discovery, generation, and organization. Technical writers, product documentation owners, knowledge managers, and teams in Japanese-speaking organizations that have chosen esa for centralized knowledge storage.

Common use cases

• Search a team's esa knowledge base and have Claude summarize posts or generate analytical comments
• Generate new articles or drafts from AI analysis of existing content and team context
• Bulk-organize or refactor category structures with AI-assisted categorization
• Duplicate and customize posts across teams or workspaces
• Retrieve documentation snippets into AI workflows for reference or analysis

Setup pitfalls

• Requires ESA_ACCESS_TOKEN environment variable; PAT v2 tokens with scopes for posts, categories, comments, and attachments are recommended
• Install via npx @esaio/esa-mcp-server (requires Node.js) or Docker image ghcr.io/esaio/esa-mcp-server
• Images smaller than 30 MB in standard formats (JPEG, PNG, GIF, WebP) are embedded as base64; larger files or other formats return 5-minute signed URLs
• UI language defaults to Japanese; set LANG environment variable to change (e.g., en for English)