Skip to content

Commit f871766

Browse files
rianvdmrianvdm
committed
docs: update connection instructions for Claude Desktop and other clients
Updated both README and marketing page with modern connection methods: PRIMARY METHOD - Claude Desktop Connectors UI: - Step-by-step visual instructions - No configuration files needed - Settings → Connectors → Add Connector → Enter URL ALTERNATIVE METHODS: - Claude Code: Single command with HTTP transport - Continue.dev, Zed: Config file examples - MCP Inspector: Direct testing command - Custom implementations: SDK references Removed outdated mcp-remote as primary method and positioned it as alternative for compatibility. Emphasized native HTTP transport support as the modern standard. Fixes apply to: - README.md Quick Start section - marketing-page.ts Setup section Connection now working with Claude Desktop using Streamable HTTP!
1 parent 0c31e9e commit f871766

File tree

2 files changed

+79
-22
lines changed

2 files changed

+79
-22
lines changed

‎README.md‎

Lines changed: 54 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -36,37 +36,84 @@ That's it! Claude Code now supports HTTP transport natively, no additional tools
3636

3737
### Using with Claude Desktop
3838

39-
**Modern Method (HTTP Transport):**
39+
**Recommended Method (Connectors UI):**
4040

41-
Add this configuration to your Claude Desktop settings (Settings / Developer / Edit config):
41+
Claude Desktop now supports remote MCP servers natively:
42+
43+
1. Open Claude Desktop
44+
2. Go to **Settings** → **Connectors**
45+
3. Click **Add Connector**
46+
4. Enter the server URL: `https://lastfm-mcp-prod.rian-db8.workers.dev`
47+
5. Click **Add**
48+
49+
That's it! No configuration files or command-line tools needed. The server will appear in your Connectors list and be ready to use.
50+
51+
**Alternative Method (Configuration File):**
52+
53+
For advanced users who prefer config files, add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
4254

4355
```json
4456
{
4557
"mcpServers": {
4658
"lastfm": {
4759
"command": "npx",
48-
"args": ["-y", "@modelcontextprotocol/server-everything", "https://lastfm-mcp-prod.rian-db8.workers.dev"]
60+
"args": ["-y", "mcp-remote", "https://lastfm-mcp-prod.rian-db8.workers.dev"]
4961
}
5062
}
5163
}
5264
```
5365

54-
**Legacy Method (via mcp-remote):**
66+
> **💡 Note**: The Connectors UI method is recommended as it's simpler and doesn't require any command-line tools.
67+
68+
### Using with Other MCP Clients
69+
70+
This server works with any MCP client that supports Streamable HTTP transport:
5571

56-
If you prefer the older approach or encounter issues:
72+
**Continue.dev (VS Code/JetBrains):**
73+
74+
Add to your Continue config (`~/.continue/config.json`):
5775

5876
```json
5977
{
6078
"mcpServers": {
6179
"lastfm": {
6280
"command": "npx",
63-
"args": ["mcp-remote", "https://lastfm-mcp-prod.rian-db8.workers.dev/sse"]
81+
"args": ["-y", "mcp-remote", "https://lastfm-mcp-prod.rian-db8.workers.dev"]
82+
}
83+
}
84+
}
85+
```
86+
87+
**Zed Editor:**
88+
89+
Add to your Zed settings:
90+
91+
```json
92+
{
93+
"context_servers": {
94+
"lastfm": {
95+
"command": "npx",
96+
"args": ["-y", "mcp-remote", "https://lastfm-mcp-prod.rian-db8.workers.dev"]
6497
}
6598
}
6699
}
67100
```
68101

69-
> **💡 Note**: The HTTP transport method is recommended as it's simpler and works directly without proxying.
102+
**MCP Inspector (Testing):**
103+
104+
Test the server directly:
105+
106+
```bash
107+
npx @modelcontextprotocol/inspector https://lastfm-mcp-prod.rian-db8.workers.dev
108+
```
109+
110+
**Custom Implementation:**
111+
112+
Use the MCP client SDK for your language:
113+
- **TypeScript/JavaScript**: `@modelcontextprotocol/sdk`
114+
- **Python**: `mcp` package
115+
- Server endpoint: `https://lastfm-mcp-prod.rian-db8.workers.dev`
116+
- Transport: Streamable HTTP (protocol version 2024-11-05 or 2025-06-18)
70117

71118
#### 🐛 Platform-Specific Troubleshooting
72119

‎src/marketing-page.ts‎

Lines changed: 25 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -524,8 +524,8 @@ export const MARKETING_PAGE_HTML = `<!DOCTYPE html>
524524
<div class="setup-steps">
525525
<div class="step">
526526
<div class="step-number">1</div>
527-
<h3>Add to Claude Desktop</h3>
528-
<p>Configure the MCP server in your Claude Desktop settings</p>
527+
<h3>Add Server</h3>
528+
<p>Connect via Claude Desktop Connectors UI or your preferred MCP client</p>
529529
</div>
530530
531531
<div class="step">
@@ -541,33 +541,43 @@ export const MARKETING_PAGE_HTML = `<!DOCTYPE html>
541541
</div>
542542
</div>
543543
544-
<p style="text-align: center; margin-bottom: 1rem;"><strong>Recommended: HTTP Transport (Claude Code, MCP Inspector)</strong></p>
545-
<p style="text-align: center; color: #666; margin-bottom: 1rem;">Modern connection method with native HTTP support</p>
544+
<p style="text-align: center; margin-bottom: 1rem; margin-top: 3rem;"><strong>✨ Recommended: Claude Desktop Connectors UI</strong></p>
545+
<p style="text-align: center; color: #666; margin-bottom: 1rem;">The easiest way to connect - no configuration files needed!</p>
546+
<div style="text-align: center; margin: 2rem 0;">
547+
<ol style="display: inline-block; text-align: left; color: #333; line-height: 2;">
548+
<li>Open Claude Desktop</li>
549+
<li>Go to <strong>Settings → Connectors</strong></li>
550+
<li>Click <strong>Add Connector</strong></li>
551+
<li>Enter URL: <code style="background: #f0f0f0; padding: 2px 8px; border-radius: 4px;">https://lastfm-mcp-prod.rian-db8.workers.dev</code></li>
552+
<li>Click <strong>Add</strong></li>
553+
</ol>
554+
</div>
555+
556+
<p style="text-align: center; margin-bottom: 1rem; margin-top: 3rem;"><strong>💻 Claude Code (Terminal)</strong></p>
557+
<p style="text-align: center; color: #666; margin-bottom: 1rem;">One command to add the server</p>
546558
547559
<div class="code-block">
548-
<pre>{
549-
"mcpServers": {
550-
"lastfm": {
551-
"command": "claude",
552-
"args": ["mcp", "add", "--transport", "http", "lastfm", "https://lastfm-mcp-prod.rian-db8.workers.dev"]
553-
}
554-
}
555-
}</pre>
560+
<pre>claude mcp add --transport http lastfm https://lastfm-mcp-prod.rian-db8.workers.dev</pre>
556561
</div>
557562
558-
<p style="text-align: center; margin-bottom: 1rem; margin-top: 3rem;"><strong>Legacy: mcp-remote Method</strong></p>
559-
<p style="text-align: center; color: #666; margin-bottom: 1rem;">For older Claude Desktop versions that don't support HTTP transport</p>
563+
<p style="text-align: center; margin-bottom: 1rem; margin-top: 3rem;"><strong>🔧 Other MCP Clients</strong></p>
564+
<p style="text-align: center; color: #666; margin-bottom: 1rem;">Continue.dev, Zed, or custom implementations</p>
560565
561566
<div class="code-block">
562567
<pre>{
563568
"mcpServers": {
564569
"lastfm": {
565570
"command": "npx",
566-
"args": ["mcp-remote", "https://lastfm-mcp-prod.rian-db8.workers.dev/sse"]
571+
"args": ["-y", "mcp-remote", "https://lastfm-mcp-prod.rian-db8.workers.dev"]
567572
}
568573
}
569574
}</pre>
570575
</div>
576+
577+
<p style="text-align: center; margin-bottom: 1rem; margin-top: 3rem;"><strong>🧪 Test with MCP Inspector</strong></p>
578+
<div class="code-block">
579+
<pre>npx @modelcontextprotocol/inspector https://lastfm-mcp-prod.rian-db8.workers.dev</pre>
580+
</div>
571581
</div>
572582
</section>
573583

0 commit comments

Comments
 (0)