MCP
MCP Overview
Connect Stora to Claude Code and other AI assistants using the Model Context Protocol (MCP).
Stora MCP Server#
The Stora MCP server lets you manage your entire App Store workflow from Claude Code or any MCP-compatible AI assistant — generate screenshots, optimize metadata, run compliance checks, and submit to stores, all from your terminal.
What is MCP?#
The Model Context Protocol (MCP) is an open standard for connecting AI assistants to external tools and data sources. Instead of copy-pasting between your terminal and the Stora dashboard, MCP lets your AI assistant call Stora directly.
Why Use Stora MCP?#
- Stay in your editor — Generate screenshots, update metadata, and submit without leaving your terminal.
- Natural language — Ask Claude to "generate screenshots for my app" instead of navigating UIs.
- Automation — Chain Stora operations into larger workflows alongside your other development tools.
Prerequisites#
- Node.js 18+ — Required to run the MCP server.
- Claude Code (or any MCP-compatible client) — The AI assistant that will connect to Stora.
- Stora API Key — Generated from your Stora dashboard.
Installation#
No installation step is needed. The server runs via npx:
npx @stora-sh/mcp
Configuration#
Add the Stora MCP server to your Claude Code configuration:
{
"mcpServers": {
"stora": {
"command": "npx",
"args": ["-y", "@stora-sh/mcp"],
"env": {
"STORA_API_KEY": "your_key_here"
}
}
}
}
Place this in your Claude Code MCP config file (.claude/mcp.json in your project or ~/.claude/mcp.json globally).
Getting Your API Key#
- Go to stora.sh/settings.
- Navigate to API & MCP.
- Click Create API Key.
- Copy the key (starts with
sk_stora_...) and add it to your config.
Warning: Keep your API key secret. Do not commit it to version control. Use environment variables or a secrets manager in CI/CD.
Quick Example#
Once configured, you can ask Claude Code things like:
"List my Stora projects and generate screenshots for Versed."
Claude will call the stora_list_projects tool to find your projects, then stora_generate_screenshots to kick off a capture, and finally poll stora_get_screenshots until the results are ready.
Environment Variables#
| Variable | Required | Description |
|---|---|---|
| STORA_API_KEY | Yes | Your Stora API key (starts with sk_stora_...) |
| STORA_BASE_URL | No | Override the base URL. Only needed for self-hosted Stora instances. Defaults to https://stora.sh. |
Troubleshooting#
"STORA_API_KEY is not set"#
Make sure the env block in your MCP config includes the key. Double-check that the key starts with sk_stora_.
Server not starting#
Run npx @stora-sh/mcp manually in your terminal to see error output. Common causes:
- Node.js version below 18. Check with
node -v. - Network issues preventing the npm package from downloading. Try
npx -y @stora-sh/mcpto bypass the cache.
Tools not appearing in Claude Code#
Restart Claude Code after editing your MCP configuration. The server list is read on startup.
Tip: Run
/mcpinside Claude Code to see the status of all connected MCP servers and verify Stora is listed.
Next Steps#
- Tools Reference — Full documentation for all 10 MCP tools.
- API Reference — Use the REST API directly if you need programmatic access outside of MCP.