Agent skill

installing-project-mcps

Install MCP servers into the current project scope using claude mcp add. Use when setting up a new project, when user mentions MCP setup, project MCP, MCPインストール, MCPセットアップ, or /installing-project-mcps.

View SKILL.md on GitHub Repository
Stars 5
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/camoneart/claude-code/tree/main/skills/installing-project-mcps

SKILL.md

Installing Project MCPs

プロジェクトスコープにMCPサーバーをインストールするワークフロー。

ワークフロー

1. レジストリ読み込み
   ↓
2. ユーザーにインストール対象を確認（AskUserQuestion）
   ↓
3. claude mcp add --scope project で追加
   ↓
4. 検証（.mcp.json 確認）

実行手順

Step 1: レジストリ読み込み

references/mcp-registry.md を読み込み、利用可能なMCPサーバー一覧を把握する。

Step 2: ユーザーに選択させる

AskUserQuestionを使って、インストールするMCPを確認する。

提示する選択肢（カテゴリ別）:

ブラウザ・フロントエンド開発:

  • next-devtools（Next.js開発）

コード分析・開発支援:

  • serena（セマンティックコード分析）
  • maestro（マルチエージェント）

Step 3: インストール実行

選択されたMCPに対して claude mcp add を実行する。

stdio方式のMCP

bash
claude mcp add --scope project <name> -- <command> [args...]

具体例:

bash
# next-devtools
claude mcp add --scope project next-devtools -- npx next-devtools-mcp@latest

# serena
claude mcp add --scope project serena -- uvx --from git+https://github.com/oraios/serena serena start-mcp-server

# maestro
claude mcp add --scope project maestro -- maestro-mcp-server

Step 4: 検証

インストール完了後、以下を確認:

  1. .mcp.json がプロジェクトルートに生成されていること
  2. claude mcp list で追加したMCPが表示されること
bash
# プロジェクトの .mcp.json を確認
cat .mcp.json

# インストール済みMCP一覧
claude mcp list

エラーハンドリング

claude mcp add が失敗する場合

  1. コマンドのパスを確認（npx, uvx 等が利用可能か）
  2. ネットワーク接続を確認
  3. 既に同名のMCPが登録されている場合は claude mcp remove <name> してから再追加

npxコマンドが見つからない場合

Node.jsがインストールされていることを確認:

bash
node --version
npx --version

uvxコマンドが見つからない場合

uv（Python パッケージマネージャー）がインストールされていることを確認:

bash
uv --version

チェックリスト

  • レジストリを読み込んだ
  • ユーザーにインストール対象を確認した
  • claude mcp add --scope project でインストールした
  • .mcp.json が正しく生成されたことを確認した
  • claude mcp list で追加を確認した

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

camoneart/claude-code

translating-technical-articles

Translates English technical articles (engineering blogs, documentation) to Japanese while preserving layout and structure. Use when the user asks to translate an article, convert English content to Japanese, or mentions translating a URL or technical blog post.

5 0
Explore
camoneart/claude-code

guiding-tdd-development

Guide Test-Driven Development with task splitting, Red-Green-Refactor cycle, and framework auto-detection. Use when developing features with TDD approach, fixing bugs test-first, or when user mentions "TDD", "テスト駆動開発", "test-first", "/tdd".

5 0
Explore
camoneart/claude-code

distributed-tracing

Implement distributed tracing with Jaeger and Tempo to track requests across microservices and identify performance bottlenecks. Use when debugging microservices, analyzing request flows, or implementing observability for distributed systems.

5 0
Explore
camoneart/claude-code

dependency-upgrade

Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing. Use when upgrading framework versions, updating major dependencies, or managing breaking changes in libraries.

5 0
Explore
camoneart/claude-code

stripe-integration

Implement Stripe payment processing for robust, PCI-compliant payment flows including checkout, subscriptions, and webhooks. Use when integrating Stripe payments, building subscription systems, or implementing secure checkout flows.

5 0
Explore
camoneart/claude-code

typescript-advanced-types

Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications. Use when implementing complex type logic, creating reusable type utilities, or ensuring compile-time type safety in TypeScript projects.

5 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results