概要
XcodeAgentic Coding AssistantにMCPサーバーを連携する方法をまとめる。
手順
1. 設定ファイルのパス
MCPサーバーはClaude Codeの設定ファイルでプロジェクトごとに構成する。
~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/.claude.json
2. 設定構造
projects内にプロジェクトパスをキーとして指定しmcpServersに使用するMCPサーバーを追加する。
{
"projects": {
"/path/to/your/project": {
"mcpServers": {
// MCPサーバー設定
}
}
}
}
3. MCPサーバーの種類
MCPサーバーは2つのタイプで設定できる。
3.1. stdio
CLIコマンドでMCPサーバープロセスを直接起動する方式だ。
{
"projects": {
"/path/to/your/project": {
"mcpServers": {
"context7": {
"type": "stdio",
"command": "/path/to/npx",
"args": ["-y", "@upstash/context7-mcp@latest"]
}
}
}
}
}
| 項目 | 説明 |
|---|---|
| type | "stdio"を指定する。 |
| command | 実行するコマンドの絶対パスを入力する。（例：npx、uvx） |
| args | コマンドに渡す引数の配列だ。 |
| env | （任意）環境変数を指定する。APIトークンなどが必要な場合に使用する。 |
3.2. SSE (Server-Sent Events)
ローカルで実行中のMCPサーバーにHTTPで接続する方式だ。
{
"projects": {
"/path/to/your/project": {
"mcpServers": {
"Figma Dev Mode MCP": {
"type": "sse",
"url": "http://127.0.0.1:3845/sse"
}
}
}
}
}
| 項目 | 説明 |
|---|---|
| type | "sse"を指定する。 |
| url | MCPサーバーのSSEエンドポイントURLを入力する。 |
4. 設定例
複数のMCPサーバーをまとめて構成した例だ。
{
"projects": {
"/path/to/your/project": {
"mcpServers": {
"context7": {
"type": "stdio",
"command": "/path/to/npx",
"args": ["-y", "@upstash/context7-mcp@latest"]
},
"sequential-thinking": {
"type": "stdio",
"command": "/path/to/npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
},
"mcp-atlassian": {
"type": "stdio",
"command": "/path/to/uvx",
"args": ["mcp-atlassian"],
"env": {
"CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
"CONFLUENCE_USERNAME": "your-email@example.com",
"CONFLUENCE_API_TOKEN": "your-api-token",
"JIRA_URL": "https://your-domain.atlassian.net",
"JIRA_USERNAME": "your-email@example.com",
"JIRA_API_TOKEN": "your-api-token"
}
},
"Figma Dev Mode MCP": {
"type": "sse",
"url": "http://127.0.0.1:3845/sse"
}
}
}
}
}
| MCPサーバー | 用途 |
|---|---|
| context7 | ライブラリドキュメントをコンテキストとして提供する。 |
| sequential-thinking | 複雑な問題をステップごとに思考する機能を追加する。 |
| mcp-atlassian | JiraイシューとConfluenceドキュメントにアクセスできるようにする。 |
| Figma Dev Mode MCP | Figmaデザインファイルをコードから参照できるようにする。 |
5. 注意事項
commandにはバイナリの絶対パスを入力する必要がある。nvmなどでNode.jsを管理している場合はwhich npxでパスを確認する。envにAPIトークンやパスワードを入力する場合は設定ファイルが外部に漏洩しないよう注意する。- 設定変更後はXcodeを再起動する必要がある。
コメントする