capawesome-mcp

Connects MCP clients to the hosted Capawesome MCP server for documentation search and Cloud management.

1|Updated Aug 25, 2026
One-click install
npx skills add https://github.com/involvex/ionic-everywhere --skill capawesome-mcp-involvex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: capawesome-mcp
Source: https://github.com/involvex/ionic-everywhere/tree/main/.agents/skills/capawesome-mcp
Command: npx skills add https://github.com/involvex/ionic-everywhere --skill capawesome-mcp-involvex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up an MCP server involves client-specific configuration formats, API token handling, toolset selection, and verification steps that are easy to get wrong. This Skill guides an agent through connecting Claude Code, Claude Desktop, Cursor, or VS Code to the hosted Capawesome MCP server so documentation search and Capawesome Cloud management tools work correctly on the first attempt. ## Core Features & Use Cases - Client auto-detection and setup: Detects the MCP client from project files (.mcp.json, .cursor/, .vscode/) and applies the correct configuration for Claude Code, Claude Desktop, Cursor, or VS Code. - Toolset and read-only configuration: Builds the server URL with the right toolsets query parameter (docs, cloud, all, or named subsets) and optional readonly mode for shared or CI setups. - Secure token handling: Guides API token creation in the Capawesome Cloud Console and keeps tokens out of Git-tracked files using user-scoped config, environment variables, or VS Code input prompts. - Verification and troubleshooting: Verifies the connection with search_docs and cloud_get_current_user, and resolves common errors like 401 Unauthorized, missing cloud tools, and unquoted URLs. - Use Case: A developer wants their AI assistant to search current Capawesome plugin documentation and trigger cloud builds. The agent detects they use Cursor, writes the mcp.json entry with toolsets=all, and verifies the connection. ## Quick Start Connect my MCP client to the hosted Capawesome MCP server with documentation search and Cloud tools enabled.

Frequently Asked Questions about capawesome-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Claude Code to the Capawesome MCP server?

Run claude mcp add --transport http capawesome "https://mcp.capawesome.io/mcp?toolsets=all" --header "Authorization: Bearer YOUR_TOKEN" in the project root. Use --scope user to keep the token out of the Git-tracked .mcp.json file, then verify with claude mcp list.

How do I set up an MCP server in Cursor or VS Code?

In Cursor, add the server URL and Authorization header to .cursor/mcp.json or ~/.cursor/mcp.json. In VS Code, add the server to .vscode/mcp.json with an inputs promptString entry so the token is prompted for and stored securely instead of committed.

Does the Capawesome MCP server require an API token?

No token is needed for the documentation tools (search_docs, get_doc_page, list_blog_posts), which are registered by default. An API token from the Capawesome Cloud Console is only required for the cloud_* management tools.

Why do cloud tools not appear after adding the MCP server?

The server URL is missing ?toolsets=all or a cloud-* toolset parameter, or the Authorization header was not sent. Check that the URL includes the toolsets parameter and the header value is exactly "Bearer <TOKEN>" with the space.

How do I make an MCP server read-only for CI setups?

Append readonly=true to the server URL, for example ?toolsets=all&readonly=true. This registers only read-only tools, so nothing can be created, changed, or deleted, which is recommended for shared, unattended, or CI environments.

Why does the shell drop the MCP server URL query parameters?

The URL was not quoted on the command line, so the shell interprets characters like ? and &. Wrap the full URL in double quotes when passing it to commands such as claude mcp add.