From be9452ab233ec15e4f5ec430d76fd62bf2e1faad Mon Sep 17 00:00:00 2001 From: Matteo Date: Tue, 19 May 2026 10:56:29 +0200 Subject: [PATCH] docs(sorare): no-code primary flow + light-mode bubble fix MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Three changes that came from a real user testing the guides on the deployed website. 1. The Claude / ChatGPT / Copilot guides led with the code-level MCP config (claude_desktop_config.json, settings.json), which buried the fact that all three clients now have a no-code UI for adding MCP connectors. Rewritten: - Claude: lead with claude.ai/customize/connectors → Add custom connector → paste URL + Bearer token → Connect. Demote the desktop JSON config and Claude Code CLI to an
block labelled 'Advanced'. - ChatGPT: keep the Settings → Connectors UI as the primary path, but switch the cloud URL to cloud.anythingmcp.com explicitly (instead of 'your-anythingmcp-host'), since the no-install callout already pushes everyone to the managed cloud. Demote self-host to
. - Copilot: lead with the VS Code Command Palette path ('MCP: Add Server'), HTTP option, paste URL + Bearer token. Demote settings.json JSON to
. All three apply uniformly to en / de / it (9 files total). 2. The blue user bubble in the chat mockup rendered as illegible text on the light-mode site because the website's MDX components apply text-muted-foreground to descendant text and that wins over the Tailwind text-white class. Fixed defensively in the three announcement landings (en / de / it): - Added Tailwind '!' important prefix to text-white / text-zinc-* classes on the chat bubbles. - Wrapped the bubble text content (including inlines) in inline-style spans with color: #ffffff to bypass any future CSS-precedence regressions. 3. Replaced the outdated 7-row tool tables in the three Claude guides with the proper 18-tool grouped table (Identity, Cards, Players, Market, GraphQL escape hatch) — matches the current adapter state shipped in v0.1.25. --- .../guides/de/connect-sorare-to-chatgpt.mdx | 61 +++++++++++-------- .../guides/de/connect-sorare-to-claude.mdx | 52 ++++++++++++---- .../guides/de/connect-sorare-to-copilot.mdx | 43 ++++++++----- .../guides/de/sorare-now-on-anythingmcp.mdx | 18 +++--- .../guides/en/connect-sorare-to-chatgpt.mdx | 61 +++++++++++-------- .../guides/en/connect-sorare-to-claude.mdx | 52 ++++++++++++---- .../guides/en/connect-sorare-to-copilot.mdx | 43 ++++++++----- .../guides/en/sorare-now-on-anythingmcp.mdx | 18 +++--- .../guides/it/connect-sorare-to-chatgpt.mdx | 61 +++++++++++-------- .../guides/it/connect-sorare-to-claude.mdx | 52 ++++++++++++---- .../guides/it/connect-sorare-to-copilot.mdx | 43 ++++++++----- .../guides/it/sorare-now-on-anythingmcp.mdx | 18 +++--- 12 files changed, 336 insertions(+), 186 deletions(-) diff --git a/content/guides/de/connect-sorare-to-chatgpt.mdx b/content/guides/de/connect-sorare-to-chatgpt.mdx index 4666911..0a07799 100644 --- a/content/guides/de/connect-sorare-to-chatgpt.mdx +++ b/content/guides/de/connect-sorare-to-chatgpt.mdx @@ -36,41 +36,52 @@ ChatGPT unterstützt das **Model Context Protocol** in Custom Connectors und in 1. Bei https://sorare.com einloggen. 2. (Optional) dediziertes Read-only-Konto ohne 2FA anlegen. -### Schritt 2 — Sorare-Adapter installieren +### Schritt 2 — Sorare-Adapter auf cloud.anythingmcp.com installieren (kein Code) + +1. Auf **[cloud.anythingmcp.com](https://cloud.anythingmcp.com)** einloggen. +2. **Connectors → Sorare → Install** öffnen. +3. Einfügen: + - `SORARE_EMAIL` — deine Sorare-Kontomail + - `SORARE_PASSWORD` — Klartext-Passwort (wird vor dem Login lokal bcrypt-gehasht; nie unverschlüsselt gespeichert) +4. MCP-API-Key erzeugen unter **Profile → MCP API Keys → New Key**. Kopieren. + +Es gibt kein AUD-Feld — der Adapter setzt den JWT-Audience-Claim fest auf `anythingmcp`. + +### Schritt 3 — Connector in ChatGPT einfügen (kein Code, 4 Klicks) + +1. In ChatGPT **Einstellungen → Connectors → Custom Connector hinzufügen** öffnen. +2. Eintragen: + - **Name:** `Sorare` + - **URL:** `https://cloud.anythingmcp.com/mcp` + - **Authentication:** Bearer Token → MCP-API-Key aus Schritt 2 einfügen +3. **Speichern** klicken. +4. ChatGPT entdeckt automatisch alle 18 Sorare-Tools und zeigt sie in der Connector-Liste. + +Fertig — los geht's. ChatGPT kann nur **öffentliche HTTPS-URLs** erreichen, und genau das ist `cloud.anythingmcp.com`. + +
+Fortgeschritten: AnythingMCP selbst hosten und für ChatGPT exponieren + +Wenn du AnythingMCP lieber auf eigener Hardware betreibst, brauchst du trotzdem eine öffentliche HTTPS-URL, damit ChatGPT die Instanz erreicht. ```bash git clone https://github.com/HelpCode-ai/anythingmcp.git cd anythingmcp && docker compose up -d ``` -`http://localhost:3000/connectors/store` öffnen, **Sorare** klicken, ausfüllen: - -| Feld | Wert | -|---|---| -| `SORARE_EMAIL` | Kontomail | -| `SORARE_PASSWORD` | Klartext-Passwort | - -### Schritt 3 — MCP-Connector in ChatGPT hinzufügen +`http://localhost:3000/connectors/store` öffnen, Sorare installieren, Key erzeugen, dann Port 4000 via Cloudflare Tunnel, ngrok oder eigenem TLS-Reverse-Proxy exponieren. Diese HTTPS-URL im ChatGPT-Connector-Formular statt `cloud.anythingmcp.com` verwenden. -1. In AnythingMCP MCP-API-Key erzeugen: **Profile → MCP API Keys → New Key**. -2. In ChatGPT: **Einstellungen → Connectors → Custom Connector hinzufügen**. -3. Eintragen: - - **Name**: `Sorare` - - **URL**: `https://dein-anythingmcp-host/mcp` (öffentliche HTTPS-URL — ChatGPT erreicht `localhost` nicht; via Cloudflare Tunnel / ngrok / cloud.anythingmcp.com bereitstellen). - - **Authentication**: Bearer Token → MCP-API-Key einfügen. -4. Speichern. ChatGPT entdeckt die 18 Sorare-Tools automatisch. +
-### Verfügbare Tools +### Verfügbare Tools (18 insgesamt) -| Tool | Beschreibung | +| Gruppe | Tools | |---|---| -| `sorare_current_user` | Sorare-Profil | -| `sorare_get_card_by_slug` | Karten-Metadaten + Besitzer + Auktion | -| `sorare_search_player` | Spielersuche | -| `sorare_list_player_cards` | Aktuelle Karten zu einem Spieler | -| `sorare_list_my_cards` | Eigene Karten | -| `sorare_get_lineup` | So5-Aufstellung | -| `sorare_transfer_market` | Aktive Auktionen, filterbar | +| **Identität / Wallet** | `sorare_current_user`, `sorare_wallet_balance`, `sorare_my_trophies_summary`, `sorare_user_by_slug` | +| **Karten / Inventar** | `sorare_list_my_cards`, `sorare_get_card_by_slug`, `sorare_list_player_cards` | +| **Spieler / Form** | `sorare_search_player`, `sorare_player_recent_scores`, `sorare_player_floor_price` | +| **Markt & Auktionen** | `sorare_live_sale_offers`, `sorare_token_prices`, `sorare_get_auction`, `sorare_get_lineup` | +| **Generic GraphQL Notausgang** | `sorare_graphql_schema_url`, `sorare_graphql_schema`, `sorare_graphql_query`, `sorare_graphql_mutation`, `sorare_graphql_subscription` | ## Mehr als die 18 Tools — deine KI ruft *jeden* Sorare-GraphQL-Endpoint auf diff --git a/content/guides/de/connect-sorare-to-claude.mdx b/content/guides/de/connect-sorare-to-claude.mdx index 24e62d2..25d5731 100644 --- a/content/guides/de/connect-sorare-to-claude.mdx +++ b/content/guides/de/connect-sorare-to-claude.mdx @@ -52,15 +52,32 @@ cd anythingmcp && docker compose up -d **Install** klicken — der Adapter steht mit 18 Tools (5 GraphQL-Builtins + 13 dedizierte) im Katalog. -### Schritt 3 — Claude Desktop konfigurieren +### Schritt 3 — Connector in Claude einfügen (kein Code, 4 Klicks) -MCP-API-Key unter **Profile → MCP API Keys** erzeugen, dann in `~/Library/Application Support/Claude/claude_desktop_config.json`: +Das ist der empfohlene Weg — funktioniert in der **claude.ai Web-App** ohne eine einzige Config-Datei. + +1. Öffne **[claude.ai/customize/connectors](https://claude.ai/customize/connectors)**. +2. Klicke **"Add custom connector"**. +3. Fülle aus: + - **Name:** `Sorare` + - **URL:** `https://cloud.anythingmcp.com/mcp` + - **Authentication:** Bearer Token → MCP-API-Key einfügen (aus AnythingMCP → **Profile → MCP API Keys → New Key**) +4. **Connect** klicken zum Autorisieren. + +Fertig. Alle 18 Sorare-Tools erscheinen sofort im Chat — einfach Prompts schreiben. Token-Cache, Refresh und bcrypt-Anmeldung passieren server-seitig; du siehst davon nie etwas. + +
+Fortgeschritten: Claude Desktop / Claude Code (JSON / CLI) + +Für die **Desktop-Apps** greift die Web-UI nicht — du editierst stattdessen eine lokale Config-Datei. + +**Claude Desktop** — bearbeite `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) oder `%AppData%\Claude\claude_desktop_config.json` (Windows): ```json { "mcpServers": { "sorare": { - "url": "http://localhost:4000/mcp", + "url": "https://cloud.anythingmcp.com/mcp", "headers": { "Authorization": "Bearer DEIN_MCP_API_KEY" } @@ -71,17 +88,28 @@ MCP-API-Key unter **Profile → MCP API Keys** erzeugen, dann in `~/Library/Appl Claude Desktop neu starten. Sorare-Tools erscheinen im 🔧-Menü. -### Verfügbare Tools +**Claude Code** — ein CLI-Befehl: + +```bash +claude mcp add sorare \ + --transport http \ + --url https://cloud.anythingmcp.com/mcp \ + --header "Authorization: Bearer DEIN_MCP_API_KEY" +``` + +Mit `claude mcp list` verifizieren. + +
+ +### Verfügbare Tools (18 insgesamt) -| Tool | Beschreibung | +| Gruppe | Tools | |---|---| -| `sorare_current_user` | Eigenes Profil | -| `sorare_get_card_by_slug` | Kartendetails per Slug | -| `sorare_search_player` | Spielersuche nach Name | -| `sorare_list_player_cards` | Aktuelle Karten zu einem Spieler | -| `sorare_list_my_cards` | Eigene Karten | -| `sorare_get_lineup` | So5-Score + Reward | -| `sorare_transfer_market` | Aktive Auktionen, filterbar | +| **Identität / Wallet** | `sorare_current_user`, `sorare_wallet_balance`, `sorare_my_trophies_summary`, `sorare_user_by_slug` | +| **Karten / Inventar** | `sorare_list_my_cards`, `sorare_get_card_by_slug`, `sorare_list_player_cards` | +| **Spieler / Form** | `sorare_search_player`, `sorare_player_recent_scores`, `sorare_player_floor_price` | +| **Markt & Auktionen** | `sorare_live_sale_offers`, `sorare_token_prices`, `sorare_get_auction`, `sorare_get_lineup` | +| **Generic GraphQL Notausgang** | `sorare_graphql_schema_url`, `sorare_graphql_schema`, `sorare_graphql_query`, `sorare_graphql_mutation`, `sorare_graphql_subscription` | ## Mehr als die 18 Tools — deine KI ruft *jeden* Sorare-GraphQL-Endpoint auf diff --git a/content/guides/de/connect-sorare-to-copilot.mdx b/content/guides/de/connect-sorare-to-copilot.mdx index c0e5849..2a4bc63 100644 --- a/content/guides/de/connect-sorare-to-copilot.mdx +++ b/content/guides/de/connect-sorare-to-copilot.mdx @@ -31,31 +31,42 @@ GitHub Copilot Chat unterstützt jetzt das **Model Context Protocol (MCP)** übe - AnythingMCP lokal oder auf cloud.anythingmcp.com (3-Minuten-Setup). - GitHub Copilot Chat mit MCP-Support (VS Code Insiders ≥ 1.95 oder JetBrains-Plugin mit MCP). -### Schritt 1 — Sorare-Adapter installieren +### Schritt 1 — Sorare-Adapter auf cloud.anythingmcp.com installieren (kein Code) -```bash -git clone https://github.com/HelpCode-ai/anythingmcp.git -cd anythingmcp && docker compose up -d -``` +1. Auf **[cloud.anythingmcp.com](https://cloud.anythingmcp.com)** einloggen. +2. **Connectors → Sorare → Install** öffnen. +3. Einfügen: + - `SORARE_EMAIL` — deine Sorare-Kontomail + - `SORARE_PASSWORD` — Klartext-Passwort (wird vor dem Login lokal bcrypt-gehasht; nie unverschlüsselt gespeichert) +4. MCP-API-Key erzeugen unter **Profile → MCP API Keys → New Key**. Kopieren. -Öffne `http://localhost:3000/connectors/store`, klicke **Sorare** und trage ein: +Es gibt kein AUD-Feld — der Adapter setzt den JWT-Audience-Claim fest auf `anythingmcp`. -| Feld | Wert | -|---|---| -| `SORARE_EMAIL` | Kontomail | -| `SORARE_PASSWORD` | Klartext-Passwort (vor Login lokal bcrypt-gehasht) | +### Schritt 2 — Sorare in Copilot einfügen (kein Code, Command Palette) + +In VS Code (Insiders ≥ 1.95, oder Stable mit MCP-Support): + +1. **Cmd/Ctrl + Shift + P** öffnet die Command Palette. +2. **`MCP: Add Server`** tippen und die HTTP-Option wählen. +3. Eintragen: + - **Server URL:** `https://cloud.anythingmcp.com/mcp` + - **Authorization Header:** `Bearer DEIN_MCP_API_KEY` (aus Schritt 1) +4. Server `sorare` nennen und bestätigen. -Erstelle einen MCP-API-Key unter **Profile → MCP API Keys**. +VS Code startet Copilot Chat automatisch neu. Alle 18 Sorare-Tools tauchen im Copilot-Tool-Picker auf — los geht's. -### Schritt 2 — Sorare in Copilots MCP-Server einfügen +> **JetBrains?** Gleicher Flow — Copilot-Panel öffnen → MCP servers → Add server → URL + Bearer Token einfügen. -In VS Code: Einstellungen → suche **Copilot: MCP servers** → ergänze: +
+Fortgeschritten: settings.json manuell editieren + +Wenn du die Config-Datei direkt bearbeiten willst, öffne `settings.json` (Cmd/Ctrl + Shift + P → "Preferences: Open User Settings (JSON)") und ergänze: ```json { "mcp.servers": { "sorare": { - "url": "http://localhost:4000/mcp", + "url": "https://cloud.anythingmcp.com/mcp", "transport": "http", "headers": { "Authorization": "Bearer DEIN_MCP_API_KEY" @@ -65,10 +76,10 @@ In VS Code: Einstellungen → suche **Copilot: MCP servers** → ergänze: } ``` -Für Cloud: ersetze die URL durch `https://cloud.anythingmcp.com/mcp`. - Copilot Chat neu starten. Die 18 Sorare-Tools tauchen automatisch auf — Copilot wählt das passende Tool je nach Prompt. +
+ ### Verfügbare Tools (18) | Gruppe | Tools | diff --git a/content/guides/de/sorare-now-on-anythingmcp.mdx b/content/guides/de/sorare-now-on-anythingmcp.mdx index 516c8c4..f78599d 100644 --- a/content/guides/de/sorare-now-on-anythingmcp.mdx +++ b/content/guides/de/sorare-now-on-anythingmcp.mdx @@ -42,32 +42,32 @@ Dein KI-Client greift dabei nicht nur auf eine feste Auswahl vorgebackener Tools
-
- Ich hab 100 € für Sorare diese Woche. Such mir 3 Limited-Karten, die nächsten Spieltag punkten und 30 %+ unter ihrem 30-Tage-Schnitt liegen. Nur Top-5-Ligen. +
+ Ich hab 100 € für Sorare diese Woche. Such mir 3 Limited-Karten, die nächsten Spieltag punkten und 30 %+ unter ihrem 30-Tage-Schnitt liegen. Nur Top-5-Ligen.
-
DU
+
DU
-
CLAUDE
+
CLAUDE
-
+
Ich hole erst dein Wallet + deine Sammlung, damit ich keine Doppel empfehle, dann scanne ich die letzten So5-Top-Scorer und gleiche mit den aktuellen Marktpreisen ab.
-
+
▸ sorare_wallet_balance()
← 73,45 € EUR · 0.0042 ETH
▸ sorare_list_my_cards(rarities: ["limited"])
← 6 Karten (überwiegend 2021-22, schwach)
-
+
Deine aktuellen Limiteds sind alte Vintages aus Nebenliegen — füllen die Lücke nicht. Ich gehe frisch ran. Ich frag das Schema nach dem besten "Form vs Preis"-Winkel und schick dann eine eigene GraphQL gegen den Transfermarkt.
-
+
▸ sorare_graphql_schema(search: "topPerformers")
← Gefunden: football.topPerformers(window, league)
▸ sorare_graphql_query(custom: Top-5-Ligen, letzte 5 GWs, avg >35)
@@ -77,7 +77,7 @@ Dein KI-Client greift dabei nicht nur auf eine feste Auswahl vorgebackener Tools
← 3 Kandidaten >30 % unter 30-Tage-Schnitt ✓
-
+
Deine Kaufliste — 68 € total, 32 € Reserve
  1. Calafiori (Arsenal) · Limited · 3,20 € — 40 % unter 30-Tage-Schnitt, Stamm
    2. diff --git a/content/guides/en/connect-sorare-to-chatgpt.mdx b/content/guides/en/connect-sorare-to-chatgpt.mdx index 4c62ed2..81fab07 100644 --- a/content/guides/en/connect-sorare-to-chatgpt.mdx +++ b/content/guides/en/connect-sorare-to-chatgpt.mdx @@ -36,41 +36,52 @@ ChatGPT supports the **Model Context Protocol** in custom connectors and in the 1. Sign in to https://sorare.com. 2. (Optional) create a dedicated read-only Sorare account for MCP and disable 2FA on it. -### Step 2 — Install the Sorare adapter +### Step 2 — Install the Sorare adapter on cloud.anythingmcp.com (no code) + +1. Sign in on **[cloud.anythingmcp.com](https://cloud.anythingmcp.com)**. +2. Open **Connectors → Sorare → Install**. +3. Paste: + - `SORARE_EMAIL` — your Sorare account email + - `SORARE_PASSWORD` — your plain password (bcrypt-hashed locally before login; never stored unencrypted) +4. Mint an MCP API key under **Profile → MCP API Keys → New Key**. Copy it. + +There is no AUD field — the adapter hardcodes the JWT audience to `anythingmcp`. + +### Step 3 — Add the connector in ChatGPT (no code, 4 clicks) + +1. In ChatGPT, open **Settings → Connectors → Add custom connector**. +2. Fill in: + - **Name:** `Sorare` + - **URL:** `https://cloud.anythingmcp.com/mcp` + - **Authentication:** Bearer token → paste the MCP API key from Step 2 +3. Click **Save**. +4. ChatGPT auto-discovers all 18 Sorare tools and they appear in the connector list. + +That's it — start prompting. ChatGPT can only reach **public HTTPS** URLs, which is exactly what `cloud.anythingmcp.com` is. + +
    +Advanced: self-host AnythingMCP and expose it to ChatGPT + +If you'd rather run AnythingMCP on your own hardware, you still need a public HTTPS URL so ChatGPT can reach it. ```bash git clone https://github.com/HelpCode-ai/anythingmcp.git cd anythingmcp && docker compose up -d ``` -Open `http://localhost:3000/connectors/store`, click **Sorare**, and provide: - -| Field | Value | -|---|---| -| `SORARE_EMAIL` | account email | -| `SORARE_PASSWORD` | plain password | - -### Step 3 — Add the MCP connector in ChatGPT +Open `http://localhost:3000/connectors/store`, install Sorare, mint a key, then expose port 4000 via Cloudflare Tunnel, ngrok or any reverse proxy with TLS. Use that HTTPS URL in the ChatGPT connector form instead of `cloud.anythingmcp.com`. -1. Mint an MCP API key in AnythingMCP: **Profile → MCP API Keys → New Key**. -2. In ChatGPT, open **Settings → Connectors → Add custom connector**. -3. Fill in: - - **Name**: `Sorare` - - **URL**: `https://your-anythingmcp-host/mcp` (use a public HTTPS URL — ChatGPT cannot reach `localhost`; expose with Cloudflare Tunnel / ngrok / cloud.anythingmcp.com). - - **Authentication**: Bearer token → paste the MCP API key. -4. Save. ChatGPT auto-discovers the 18 Sorare tools. +
    -### Available tools +### Available tools (18 total) -| Tool | Description | +| Group | Tools | |---|---| -| `sorare_current_user` | Your Sorare profile | -| `sorare_get_card_by_slug` | Card metadata + owner + auction | -| `sorare_search_player` | Players by name | -| `sorare_list_player_cards` | Recent cards for a player | -| `sorare_list_my_cards` | Your owned cards | -| `sorare_get_lineup` | So5 lineup details | -| `sorare_transfer_market` | Active auctions, filterable | +| **Identity / wallet** | `sorare_current_user`, `sorare_wallet_balance`, `sorare_my_trophies_summary`, `sorare_user_by_slug` | +| **Cards / inventory** | `sorare_list_my_cards`, `sorare_get_card_by_slug`, `sorare_list_player_cards` | +| **Players / form** | `sorare_search_player`, `sorare_player_recent_scores`, `sorare_player_floor_price` | +| **Market & auctions** | `sorare_live_sale_offers`, `sorare_token_prices`, `sorare_get_auction`, `sorare_get_lineup` | +| **Generic GraphQL escape hatch** | `sorare_graphql_schema_url`, `sorare_graphql_schema`, `sorare_graphql_query`, `sorare_graphql_mutation`, `sorare_graphql_subscription` | ## Beyond the 18 tools — your AI calls *any* Sorare GraphQL operation diff --git a/content/guides/en/connect-sorare-to-claude.mdx b/content/guides/en/connect-sorare-to-claude.mdx index fbec2b2..d3a695d 100644 --- a/content/guides/en/connect-sorare-to-claude.mdx +++ b/content/guides/en/connect-sorare-to-claude.mdx @@ -52,15 +52,32 @@ Open `http://localhost:3000/connectors/store`, click **Sorare**, and fill in: Click **Install** — the adapter is now in your catalog with 18 tools (5 GraphQL builtins + 13 dedicated). -### Step 3 — Wire up Claude Desktop +### Step 3 — Add the connector in Claude (no code, 4 clicks) -Mint an MCP API key in **Profile → MCP API Keys**, then add to `~/Library/Application Support/Claude/claude_desktop_config.json`: +This is the recommended path — works on **claude.ai web** without touching any config file. + +1. Open **[claude.ai/customize/connectors](https://claude.ai/customize/connectors)**. +2. Click **"Add custom connector"**. +3. Fill in: + - **Name:** `Sorare` + - **URL:** `https://cloud.anythingmcp.com/mcp` + - **Authentication:** Bearer token → paste your MCP API key (from AnythingMCP → **Profile → MCP API Keys → New Key**) +4. Click **Connect** to authorize. + +That's it. All 18 Sorare tools appear in your chat — start typing prompts. The token cache, refresh and bcrypt sign-in are all handled server-side; you never see them. + +
    +Advanced: Claude Desktop / Claude Code (JSON / CLI) + +For the **desktop apps**, the web UI doesn't apply — you edit a local config file instead. + +**Claude Desktop** — edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%AppData%\Claude\claude_desktop_config.json` (Windows): ```json { "mcpServers": { "sorare": { - "url": "http://localhost:4000/mcp", + "url": "https://cloud.anythingmcp.com/mcp", "headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" } @@ -71,17 +88,28 @@ Mint an MCP API key in **Profile → MCP API Keys**, then add to `~/Library/Appl Restart Claude Desktop. Sorare tools appear in the 🔧 menu. -### Available tools +**Claude Code** — one CLI command: + +```bash +claude mcp add sorare \ + --transport http \ + --url https://cloud.anythingmcp.com/mcp \ + --header "Authorization: Bearer YOUR_MCP_API_KEY" +``` + +Verify with `claude mcp list`. + +
    + +### Available tools (18 total) -| Tool | Description | +| Group | Tools | |---|---| -| `sorare_current_user` | Get your authenticated profile | -| `sorare_get_card_by_slug` | Card details by slug | -| `sorare_search_player` | Search players by name | -| `sorare_list_player_cards` | Recent cards for a player | -| `sorare_list_my_cards` | Your owned cards | -| `sorare_get_lineup` | So5 lineup score + reward | -| `sorare_transfer_market` | Active auctions, filterable | +| **Identity / wallet** | `sorare_current_user`, `sorare_wallet_balance`, `sorare_my_trophies_summary`, `sorare_user_by_slug` | +| **Cards / inventory** | `sorare_list_my_cards`, `sorare_get_card_by_slug`, `sorare_list_player_cards` | +| **Players / form** | `sorare_search_player`, `sorare_player_recent_scores`, `sorare_player_floor_price` | +| **Market & auctions** | `sorare_live_sale_offers`, `sorare_token_prices`, `sorare_get_auction`, `sorare_get_lineup` | +| **Generic GraphQL escape hatch** | `sorare_graphql_schema_url`, `sorare_graphql_schema`, `sorare_graphql_query`, `sorare_graphql_mutation`, `sorare_graphql_subscription` | ## Beyond the 18 tools — your AI calls *any* Sorare GraphQL operation diff --git a/content/guides/en/connect-sorare-to-copilot.mdx b/content/guides/en/connect-sorare-to-copilot.mdx index 0227363..ee42ec1 100644 --- a/content/guides/en/connect-sorare-to-copilot.mdx +++ b/content/guides/en/connect-sorare-to-copilot.mdx @@ -31,31 +31,42 @@ GitHub Copilot Chat now supports the **Model Context Protocol (MCP)** through it - AnythingMCP running locally or available on cloud.anythingmcp.com (3-minute setup). - GitHub Copilot Chat with MCP enabled (VS Code Insiders ≥ 1.95 or JetBrains plugin with MCP support). -### Step 1 — Install the Sorare adapter +### Step 1 — Install the Sorare adapter on cloud.anythingmcp.com (no code) -```bash -git clone https://github.com/HelpCode-ai/anythingmcp.git -cd anythingmcp && docker compose up -d -``` +1. Sign in on **[cloud.anythingmcp.com](https://cloud.anythingmcp.com)**. +2. Open **Connectors → Sorare → Install**. +3. Paste: + - `SORARE_EMAIL` — your Sorare account email + - `SORARE_PASSWORD` — your plain password (bcrypt-hashed locally before login; never stored unencrypted) +4. Mint an MCP API key under **Profile → MCP API Keys → New Key**. Copy it. -Open `http://localhost:3000/connectors/store`, click **Sorare**, and provide: +There is no AUD field — the adapter hardcodes the JWT audience to `anythingmcp`. -| Field | Value | -|---|---| -| `SORARE_EMAIL` | account email | -| `SORARE_PASSWORD` | plain password (bcrypt-hashed locally before login) | +### Step 2 — Add Sorare to Copilot (no code, command palette) + +In VS Code (Insiders ≥ 1.95, or stable with MCP support): + +1. **Cmd/Ctrl + Shift + P** to open the Command Palette. +2. Type **`MCP: Add Server`** and pick the HTTP option. +3. Paste: + - **Server URL:** `https://cloud.anythingmcp.com/mcp` + - **Authorization header:** `Bearer YOUR_MCP_API_KEY` (the one from Step 1) +4. Name the server `sorare` and confirm. + +VS Code restarts Copilot Chat automatically. All 18 Sorare tools appear in the Copilot tool picker — start typing prompts. -Mint an MCP API key in **Profile → MCP API Keys**. +> **JetBrains?** Same flow — open the Copilot panel → MCP servers → Add server → paste the URL + Bearer token. -### Step 2 — Add Sorare to Copilot's MCP servers +
    +Advanced: edit settings.json manually -In VS Code, open settings → search for **Copilot: MCP servers** → add: +If you'd rather edit the config file directly, open `settings.json` (Cmd/Ctrl + Shift + P → "Preferences: Open User Settings (JSON)") and add: ```json { "mcp.servers": { "sorare": { - "url": "http://localhost:4000/mcp", + "url": "https://cloud.anythingmcp.com/mcp", "transport": "http", "headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" @@ -65,9 +76,9 @@ In VS Code, open settings → search for **Copilot: MCP servers** → add: } ``` -For cloud, swap the URL for `https://cloud.anythingmcp.com/mcp`. +Restart Copilot Chat. The 18 Sorare tools appear automatically — Copilot picks the right one based on your prompt. -Restart Copilot Chat. The 18 Sorare tools appear automatically — Copilot will pick the right one based on your prompt. +
    ### Available tools (18) diff --git a/content/guides/en/sorare-now-on-anythingmcp.mdx b/content/guides/en/sorare-now-on-anythingmcp.mdx index dba37d8..1732224 100644 --- a/content/guides/en/sorare-now-on-anythingmcp.mdx +++ b/content/guides/en/sorare-now-on-anythingmcp.mdx @@ -42,32 +42,32 @@ Your AI client doesn't just call a fixed set of pre-baked tools — it has **the
    -
    - I've got €100 for Sorare this week. Find me 3 Limited cards likely to score next gameweek that are 30%+ under their 30-day average. Top 5 European leagues. +
    + I've got €100 for Sorare this week. Find me 3 Limited cards likely to score next gameweek that are 30%+ under their 30-day average. Top 5 European leagues.
    -
    YOU
    +
    YOU
    -
    CLAUDE
    +
    CLAUDE
    -
    +
    Pulling your wallet + collection first so I don't recommend duplicates, then I'll scan recent So5 scorers and cross-check current market prices.
    -
    +
    ▸ sorare_wallet_balance()
    ← €73.45 EUR · 0.0042 ETH
    ▸ sorare_list_my_cards(rarities: ["limited"])
    ← 6 cards (mostly 2021-22, weak)
    -
    +
    Your current Limiteds are all old vintages from minor leagues — won't fill the gap. I'll go fresh. Let me query the schema for the best "form vs price" angle, then run a custom GraphQL against the transfer market.
    -
    +
    ▸ sorare_graphql_schema(search: "topPerformers")
    ← Found: football.topPerformers(window, league)
    ▸ sorare_graphql_query(custom query: top5 leagues, last 5 GWs, avg score >35)
    @@ -77,7 +77,7 @@ Your AI client doesn't just call a fixed set of pre-baked tools — it has **the
    ← 3 candidates >30% below 30-day avg ✓
    -
    +
    Here's your buy list — €68 total, €32 reserve
    1. Calafiori (Arsenal) · Limited · €3.20 — 40% under 30d avg, titulair
      2. diff --git a/content/guides/it/connect-sorare-to-chatgpt.mdx b/content/guides/it/connect-sorare-to-chatgpt.mdx index 3530880..54209f1 100644 --- a/content/guides/it/connect-sorare-to-chatgpt.mdx +++ b/content/guides/it/connect-sorare-to-chatgpt.mdx @@ -36,41 +36,52 @@ ChatGPT supporta il **Model Context Protocol** nei custom connector e nell'area 1. Login su https://sorare.com. 2. (Opzionale) crea un account Sorare dedicato in sola lettura e disattiva la 2FA. -### Step 2 — Installa l'adapter Sorare +### Step 2 — Installa l'adapter Sorare su cloud.anythingmcp.com (no code) + +1. Accedi su **[cloud.anythingmcp.com](https://cloud.anythingmcp.com)**. +2. Apri **Connectors → Sorare → Install**. +3. Inserisci: + - `SORARE_EMAIL` — email del tuo account Sorare + - `SORARE_PASSWORD` — password in chiaro (hashata bcrypt localmente prima del login; non viene mai salvata in chiaro) +4. Genera una MCP API key in **Profile → MCP API Keys → New Key**. Copiala. + +Non c'è un campo AUD — l'adapter fissa l'audience del JWT a `anythingmcp`. + +### Step 3 — Aggiungi il connector in ChatGPT (no code, 4 clic) + +1. In ChatGPT apri **Impostazioni → Connectors → Aggiungi custom connector**. +2. Compila: + - **Nome:** `Sorare` + - **URL:** `https://cloud.anythingmcp.com/mcp` + - **Authentication:** Bearer token → incolla la MCP API key dallo Step 2 +3. Clicca **Salva**. +4. ChatGPT scopre automaticamente tutti e 18 i tool Sorare e li mostra nell'elenco connector. + +Fatto — vai con i prompt. ChatGPT può raggiungere solo URL **HTTPS pubblici**, ed è esattamente quello che è `cloud.anythingmcp.com`. + +
      +Avanzato: self-host AnythingMCP esposto a ChatGPT + +Se vuoi far girare AnythingMCP sul tuo hardware, ti serve comunque un URL HTTPS pubblico perché ChatGPT lo raggiunga. ```bash git clone https://github.com/HelpCode-ai/anythingmcp.git cd anythingmcp && docker compose up -d ``` -Apri `http://localhost:3000/connectors/store`, clicca **Sorare** e inserisci: - -| Campo | Valore | -|---|---| -| `SORARE_EMAIL` | email account | -| `SORARE_PASSWORD` | password in chiaro | - -### Step 3 — Aggiungi il connector MCP a ChatGPT +Apri `http://localhost:3000/connectors/store`, installa Sorare, genera la key, poi esponi la porta 4000 via Cloudflare Tunnel, ngrok o un reverse proxy con TLS. Usa quell'URL HTTPS nel form del connector ChatGPT invece di `cloud.anythingmcp.com`. -1. In AnythingMCP genera una MCP API key: **Profile → MCP API Keys → New Key**. -2. In ChatGPT: **Impostazioni → Connectors → Aggiungi custom connector**. -3. Compila: - - **Nome**: `Sorare` - - **URL**: `https://il-tuo-host-anythingmcp/mcp` (URL HTTPS pubblico — ChatGPT non vede `localhost`; esponi via Cloudflare Tunnel / ngrok / cloud.anythingmcp.com). - - **Authentication**: Bearer token → incolla la MCP API key. -4. Salva. ChatGPT scopre automaticamente i 18 tool Sorare. +
      -### Tool disponibili +### Tool disponibili (18 totali) -| Tool | Descrizione | +| Gruppo | Tool | |---|---| -| `sorare_current_user` | Profilo Sorare | -| `sorare_get_card_by_slug` | Metadata carta + proprietario + asta | -| `sorare_search_player` | Ricerca giocatori | -| `sorare_list_player_cards` | Carte recenti di un giocatore | -| `sorare_list_my_cards` | Le tue carte | -| `sorare_get_lineup` | Dettagli line-up So5 | -| `sorare_transfer_market` | Aste attive, filtrabili | +| **Identità / wallet** | `sorare_current_user`, `sorare_wallet_balance`, `sorare_my_trophies_summary`, `sorare_user_by_slug` | +| **Carte / inventario** | `sorare_list_my_cards`, `sorare_get_card_by_slug`, `sorare_list_player_cards` | +| **Giocatori / forma** | `sorare_search_player`, `sorare_player_recent_scores`, `sorare_player_floor_price` | +| **Mercato & aste** | `sorare_live_sale_offers`, `sorare_token_prices`, `sorare_get_auction`, `sorare_get_lineup` | +| **GraphQL escape hatch** | `sorare_graphql_schema_url`, `sorare_graphql_schema`, `sorare_graphql_query`, `sorare_graphql_mutation`, `sorare_graphql_subscription` | ## Oltre i 18 tool — la tua AI chiama *qualsiasi* endpoint GraphQL di Sorare diff --git a/content/guides/it/connect-sorare-to-claude.mdx b/content/guides/it/connect-sorare-to-claude.mdx index 1692b4d..85ee6de 100644 --- a/content/guides/it/connect-sorare-to-claude.mdx +++ b/content/guides/it/connect-sorare-to-claude.mdx @@ -52,15 +52,32 @@ Apri `http://localhost:3000/connectors/store`, clicca **Sorare** e compila: Clicca **Install** — l'adapter è nel catalogo con 18 tool (5 GraphQL builtins + 13 dedicati). -### Step 3 — Configura Claude Desktop +### Step 3 — Aggiungi il connector in Claude (no code, 4 clic) -Crea una MCP API key in **Profile → MCP API Keys**, poi aggiungi a `~/Library/Application Support/Claude/claude_desktop_config.json`: +Questo è il percorso consigliato — funziona nella **web app claude.ai** senza toccare nessun file di configurazione. + +1. Apri **[claude.ai/customize/connectors](https://claude.ai/customize/connectors)**. +2. Clicca **"Add custom connector"**. +3. Compila: + - **Name:** `Sorare` + - **URL:** `https://cloud.anythingmcp.com/mcp` + - **Authentication:** Bearer token → incolla la tua MCP API key (da AnythingMCP → **Profile → MCP API Keys → New Key**) +4. Clicca **Connect** per autorizzare. + +Fatto. Tutti e 18 i tool Sorare appaiono subito in chat — inizia a scrivere prompt. Cache del token, refresh e login bcrypt sono gestiti server-side; non li vedi mai. + +
      +Avanzato: Claude Desktop / Claude Code (JSON / CLI) + +Per le **app desktop** la UI web non si applica — modifichi un file di configurazione locale. + +**Claude Desktop** — edita `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) o `%AppData%\Claude\claude_desktop_config.json` (Windows): ```json { "mcpServers": { "sorare": { - "url": "http://localhost:4000/mcp", + "url": "https://cloud.anythingmcp.com/mcp", "headers": { "Authorization": "Bearer LA_TUA_MCP_API_KEY" } @@ -71,17 +88,28 @@ Crea una MCP API key in **Profile → MCP API Keys**, poi aggiungi a `~/Library/ Riavvia Claude Desktop. I tool Sorare compaiono nel menu 🔧. -### Tool disponibili +**Claude Code** — un comando CLI: + +```bash +claude mcp add sorare \ + --transport http \ + --url https://cloud.anythingmcp.com/mcp \ + --header "Authorization: Bearer LA_TUA_MCP_API_KEY" +``` + +Verifica con `claude mcp list`. + +
      + +### Tool disponibili (18 totali) -| Tool | Descrizione | +| Gruppo | Tool | |---|---| -| `sorare_current_user` | Profilo autenticato | -| `sorare_get_card_by_slug` | Dettagli carta per slug | -| `sorare_search_player` | Ricerca giocatori per nome | -| `sorare_list_player_cards` | Carte recenti di un giocatore | -| `sorare_list_my_cards` | Le tue carte | -| `sorare_get_lineup` | Line-up So5 con score + reward | -| `sorare_transfer_market` | Aste attive, filtrabili | +| **Identità / wallet** | `sorare_current_user`, `sorare_wallet_balance`, `sorare_my_trophies_summary`, `sorare_user_by_slug` | +| **Carte / inventario** | `sorare_list_my_cards`, `sorare_get_card_by_slug`, `sorare_list_player_cards` | +| **Giocatori / forma** | `sorare_search_player`, `sorare_player_recent_scores`, `sorare_player_floor_price` | +| **Mercato & aste** | `sorare_live_sale_offers`, `sorare_token_prices`, `sorare_get_auction`, `sorare_get_lineup` | +| **GraphQL escape hatch** | `sorare_graphql_schema_url`, `sorare_graphql_schema`, `sorare_graphql_query`, `sorare_graphql_mutation`, `sorare_graphql_subscription` | ## Oltre i 18 tool — la tua AI chiama *qualsiasi* endpoint GraphQL di Sorare diff --git a/content/guides/it/connect-sorare-to-copilot.mdx b/content/guides/it/connect-sorare-to-copilot.mdx index 44e5cda..6c58295 100644 --- a/content/guides/it/connect-sorare-to-copilot.mdx +++ b/content/guides/it/connect-sorare-to-copilot.mdx @@ -31,31 +31,42 @@ GitHub Copilot Chat ora supporta il **Model Context Protocol (MCP)** tramite la - AnythingMCP in locale o su cloud.anythingmcp.com (setup di 3 minuti). - GitHub Copilot Chat con MCP abilitato (VS Code Insiders ≥ 1.95 o plugin JetBrains con MCP). -### Step 1 — Installa l'adapter Sorare +### Step 1 — Installa l'adapter Sorare su cloud.anythingmcp.com (no code) -```bash -git clone https://github.com/HelpCode-ai/anythingmcp.git -cd anythingmcp && docker compose up -d -``` +1. Accedi su **[cloud.anythingmcp.com](https://cloud.anythingmcp.com)**. +2. Apri **Connectors → Sorare → Install**. +3. Inserisci: + - `SORARE_EMAIL` — email del tuo account Sorare + - `SORARE_PASSWORD` — password in chiaro (hashata bcrypt localmente prima del login; non viene mai salvata in chiaro) +4. Genera una MCP API key in **Profile → MCP API Keys → New Key**. Copiala. -Apri `http://localhost:3000/connectors/store`, clicca **Sorare** e inserisci: +Non c'è un campo AUD — l'adapter fissa l'audience del JWT a `anythingmcp`. -| Campo | Valore | -|---|---| -| `SORARE_EMAIL` | email account | -| `SORARE_PASSWORD` | password in chiaro (hashata bcrypt localmente prima del login) | +### Step 2 — Aggiungi Sorare a Copilot (no code, Command Palette) + +In VS Code (Insiders ≥ 1.95, o Stable con supporto MCP): + +1. **Cmd/Ctrl + Shift + P** per aprire la Command Palette. +2. Scrivi **`MCP: Add Server`** e seleziona l'opzione HTTP. +3. Inserisci: + - **Server URL:** `https://cloud.anythingmcp.com/mcp` + - **Authorization header:** `Bearer LA_TUA_MCP_API_KEY` (dallo Step 1) +4. Chiama il server `sorare` e conferma. -Genera una MCP API key in **Profile → MCP API Keys**. +VS Code riavvia Copilot Chat in automatico. Tutti e 18 i tool Sorare appaiono nel picker tool di Copilot — vai con i prompt. -### Step 2 — Aggiungi Sorare ai server MCP di Copilot +> **JetBrains?** Stesso flusso — apri il pannello Copilot → MCP servers → Add server → incolla URL + Bearer token. -In VS Code: Impostazioni → cerca **Copilot: MCP servers** → aggiungi: +
      +Avanzato: editing manuale di settings.json + +Se preferisci editare direttamente il file di config, apri `settings.json` (Cmd/Ctrl + Shift + P → "Preferences: Open User Settings (JSON)") e aggiungi: ```json { "mcp.servers": { "sorare": { - "url": "http://localhost:4000/mcp", + "url": "https://cloud.anythingmcp.com/mcp", "transport": "http", "headers": { "Authorization": "Bearer LA_TUA_MCP_API_KEY" @@ -65,10 +76,10 @@ In VS Code: Impostazioni → cerca **Copilot: MCP servers** → aggiungi: } ``` -Per cloud: sostituisci l'URL con `https://cloud.anythingmcp.com/mcp`. - Riavvia Copilot Chat. I 18 tool Sorare compaiono in automatico — Copilot sceglie il tool giusto in base al prompt. +
      + ### Tool disponibili (18) | Gruppo | Tool | diff --git a/content/guides/it/sorare-now-on-anythingmcp.mdx b/content/guides/it/sorare-now-on-anythingmcp.mdx index 55ceb12..30e6cfc 100644 --- a/content/guides/it/sorare-now-on-anythingmcp.mdx +++ b/content/guides/it/sorare-now-on-anythingmcp.mdx @@ -42,32 +42,32 @@ Il tuo client AI non chiama un set fisso di tool pre-confezionati — ha a dispo
      -
      - Ho 100 € da spendere su Sorare questa settimana. Trovami 3 Limited che probabilmente faranno punti la prossima GW e che sono 30 %+ sotto la loro media a 30 giorni. Solo Top 5 europee. +
      + Ho 100 € da spendere su Sorare questa settimana. Trovami 3 Limited che probabilmente faranno punti la prossima GW e che sono 30 %+ sotto la loro media a 30 giorni. Solo Top 5 europee.
      -
      TU
      +
      TU
      -
      CLAUDE
      +
      CLAUDE
      -
      +
      Prima controllo wallet + collezione per non consigliarti doppioni, poi scansiono i top So5 recenti e incrocio con i prezzi di mercato attuali.
      -
      +
      ▸ sorare_wallet_balance()
      ← 73,45 € EUR · 0.0042 ETH
      ▸ sorare_list_my_cards(rarities: ["limited"])
      ← 6 carte (per lo più 2021-22, deboli)
      -
      +
      Le tue Limited attuali sono vintage di leghe minori — non riempiono il gap. Vado fresco. Chiedo allo schema il modo migliore per fare "form vs prezzo", poi lancio una GraphQL custom sul mercato.
      -
      +
      ▸ sorare_graphql_schema(search: "topPerformers")
      ← Trovato: football.topPerformers(window, league)
      ▸ sorare_graphql_query(custom: Top 5 leghe, ultimi 5 GW, avg >35)
      @@ -77,7 +77,7 @@ Il tuo client AI non chiama un set fisso di tool pre-confezionati — ha a dispo
      ← 3 candidati >30 % sotto la media 30g ✓
      -
      +
      Ecco la tua shopping list — 68 € totali, 32 € di riserva
      1. Calafiori (Arsenal) · Limited · 3,20 € — 40 % sotto media 30g, titolare