Skip to main content

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:

bash
npx @stora-sh/mcp

Configuration#

Add the Stora MCP server to your Claude Code configuration:

json
{
  "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#

  1. Go to stora.sh/settings.
  2. Navigate to API & MCP.
  3. Click Create API Key.
  4. 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/mcp to 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 /mcp inside 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.