Semrush リモートMCPを Claude Code にMCP接続する方法(設定手順)
Semrush のリモートMCPサーバーを Claude Code に約1分でMCP接続。OAuth / 401 の問題は先に OAuth 2.1 デバッガーで確認できます。
Streamable HTTPhttps://mcp.semrush.com/v1/mcp
Install in Cursor →
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"semrush": {
"url": "https://mcp.semrush.com/v1/mcp"
}
}
}claude mcp add --transport http semrush https://mcp.semrush.com/v1/mcp
Install in VS Code →
Or add to .vscode/mcp.json:
{
"servers": {
"semrush": {
"type": "http",
"url": "https://mcp.semrush.com/v1/mcp"
}
}
}- Open Settings → Connectors (Integrations) → Add Custom Connector.
- Paste the endpoint URL:
https://mcp.semrush.com/v1/mcp - Complete the browser OAuth 2.1 login flow when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"semrush": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.semrush.com/v1/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"semrush": {
"serverUrl": "https://mcp.semrush.com/v1/mcp"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"semrush": {
"url": "https://mcp.semrush.com/v1/mcp"
}
}
}Add to ~/.codex/config.toml — Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.semrush] url = "https://mcp.semrush.com/v1/mcp"
Add to cline_mcp_settings.json (Cline → MCP Servers → Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"semrush": {
"type": "streamableHttp",
"url": "https://mcp.semrush.com/v1/mcp"
}
}
}Add to ~/.gemini/settings.json under mcpServers — httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"semrush": {
"httpUrl": "https://mcp.semrush.com/v1/mcp"
}
}
}接続手順
- 追加コマンドを実行 —
claude mcp add --transport http semrushhttps://mcp.semrush.com/v1/mcp`` を実行します。 - 認証を完了 — 初回呼び出し時に Semrush の OAuth 認可画面が開きます。許可するとツールが有効になります。Claude Code 内で
/mcpを実行すると OAuth フローが開始されます。 - 状態を確認 —
claude mcp listで接続済みと表示されれば成功です。OAuth コールバックが失敗する場合はclaude mcp remove semrushで削除して再追加し、ブラウザからコールバック URL へ到達できるか確認してください。オンライン Inspector にhttps://mcp.semrush.com/v1/mcpを貼り付け、initialize と tools/list を実行して接続を確認します。