freispace MCP — Claude Code Plugin

Run analytical queries against your freispace workspace directly from Claude, powered by the @freispace/mcp-server-analytics MCP server.

Requirements

• Node.js >= 18 (the MCP server is launched via npx)
• A freispace API key (starts with ai-), generated in your freispace team settings

Installation

From a marketplace

/plugin marketplace add freispace/freispace-claude-plugin
/plugin install freispace-analytics@freispace-claude-plugin

During installation Claude Code prompts for your freispace Analytics API Key. The key is stored in your platform's secure credential storage — never in plain-text settings files.

Without the plugin (plain MCP)

If you prefer to register the MCP server directly:

claude mcp add freispace-analytics --env FREISPACE_API_KEY=ai-xxxxx -- npx -y @freispace/mcp-server-analytics

Configuration

Setting	Env var	Description
API key (required)	FREISPACE_API_KEY	Your freispace API key, starts with ai-

Development

Validate the plugin locally:

claude plugin validate . --strict

Test it in a Claude Code session without installing from a marketplace:

claude --plugin-dir ~/freispace-claude-plugin

License

MIT © freispace GmbH