## 事象
たとえば[[DeepWiki]]の[[MCPサーバー]]追加をするため以下のコマンドを実行する。
```console
claude mcp add --transport sse deepwiki https://mcp.deepwiki.com/sse
```
このコマンドを実行したプロジェクトでは[[DeepWiki]]の[[MCPサーバー]]は利用できるが、別のプロジェクトに移動すると[[DeepWiki]]の[[MCPサーバー]]は設定されていない状態になる。
### 環境
| 対象 | バージョン |
| --------------- | ------------------- |
| [[macOS]] | 15.5 |
| [[Ghostty]] | 1.1.4-main+3e79c4b7 |
| [[Claude Code]] | 1.0.34 |
## 原因
デフォルトだとローカルスコープの設定になるから。
`~/.claude.json` を確認したところ、以下のようにプロジェクトのパスをキーとした設定の中で `mcpServers` が設定されている。
```json
"/Users/tadashi-aikawa/tmp/claude-sandbox": {
"mcpServers": {
"deepwiki": {
"type": "sse",
"url": "https://mcp.deepwiki.com/sse"
}
},
}
```
## 解決方法
`--scope user` を指定してユーザースコープの設定を行う。
```console
claude mcp add --scope user --transport sse deepwiki https://mcp.deepwiki.com/sse
```
`~/.claude.json` もトップレベルに設定が追加される。
```json
{
"mcpServers": {
"deepwiki": {
"type": "sse",
"url": "https://mcp.deepwiki.com/sse"
}
}
}
```
> [[ユーザーレベルでMCPサーバーを設定 (Claude Code)|ユーザーレベルでMCPサーバーを設定]]
## 参考
```console
$ claude mcp add -h
Usage: claude mcp add [options] <name> <commandOrUrl> [args...]
Add a server
Options:
-s, --scope <scope> Configuration scope (local, user, or project)
(default: "local")
-t, --transport <transport> Transport type (stdio, sse, http) (default:
"stdio")
-e, --env <env...> Set environment variables (e.g. -e KEY=value)
-H, --header <header...> Set HTTP headers for SSE and HTTP transports
(e.g. -H "X-Api-Key: abc123" -H "X-Custom:
value")
-h, --help Display help for command
```
> [!info]
> `--scope project` にすると、カレントディレクトリ配下に `.mcp.json` が作成され、プロジェクトのバージョン管理ファイルとして扱われる。