Skip to content
Syncore

MCP (σύνδεση AI)

Το Syncore έχει δικό του MCP server (Model Context Protocol). Με αυτόν, ένα εργαλείο AI όπως το Claude Desktop, το Claude Code ή το Cursor βλέπει τα προϊόντα, τις παραγγελίες και τα feeds σου και — αν το επιτρέψεις — κάνει αλλαγές για λογαριασμό σου, πάντα με τα δικαιώματα του χρήστη που έφτιαξε το token.

Διεύθυνση και token

https://app.syncore.gr/mcp
  • Μεταφορά: Streamable HTTP (POST με JSON-RPC, ένα μήνυμα ανά αίτημα, χωρίς SSE stream). Εκδόσεις πρωτοκόλλου: 2025-06-18, 2025-03-26, 2024-11-05.
  • Αυθεντικοποίηση: Authorization: Bearer <TOKEN>.
  • Token φτιάχνεις στη σελίδα Σύνδεση AI (MCP) του Syncore. Είναι ξεχωριστό από τα tokens του REST API:
    • mcp — μόνο ανάγνωση,
    • mcp + mcp:write — ανάγνωση και αλλαγές (επιλογή «Αλλαγές» κατά τη δημιουργία).
  • Όριο: 120 αιτήματα ανά λεπτό. Χρειάζεται ενεργή συνδρομή, όπως και το API.

Σύνδεση από clients

Claude Code

claude mcp add --transport http syncore https://app.syncore.gr/mcp --header "Authorization: Bearer <TOKEN>"

Claude Desktop

Settings → Developer → Edit Config, στο claude_desktop_config.json (χρειάζεται Node.js για το mcp-remote):

{
  "mcpServers": {
    "syncore": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.syncore.gr/mcp", "--header", "Authorization:${SYNCORE_AUTH}"],
      "env": { "SYNCORE_AUTH": "Bearer <TOKEN>" }
    }
  }
}

Cursor και άλλοι clients με headers

Στο .cursor/mcp.json ή στο αντίστοιχο αρχείο του client:

{
  "mcpServers": {
    "syncore": {
      "url": "https://app.syncore.gr/mcp",
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  }
}

ChatGPT και Connectors του claude.ai

Αυτοί οι clients συνδέονται μόνο με OAuth, που ο Syncore MCP server δεν υποστηρίζει ακόμη. Χρησιμοποίησε προς το παρόν Claude Desktop, Claude Code, Cursor ή άλλον client που δέχεται Bearer header.

Εργαλεία

Ανάγνωση (token mcp)

Εργαλείο Τι κάνει
search_products Αναζήτηση προϊόντων με όνομα, SKU ή EAN· τιμή, απόθεμα, ενεργό
get_product Πλήρη στοιχεία ενός προϊόντος: προμηθευτής, τιμές, χειροκίνητη τιμή, απόθεμα
preview_price_change Προεπισκόπηση μαζικής αλλαγής τιμής (τρέχουσα και νέα τιμή)· δεν αλλάζει τίποτα
list_orders Τελευταίες παραγγελίες, με φίλτρο κατάστασης ή αναζήτηση
get_order Μία παραγγελία με πελάτη, διευθύνσεις, γραμμές και ιστορικό κατάστασης
list_suppliers Προμηθευτές καταλόγου και αν είναι ενεργοί για σένα
feeds_status Κανάλια feeds: ενεργά, πλήθος προϊόντων, τελευταία δημιουργία, logs
dashboard_metrics Πλήθη καταλόγου, πωλήσεις (έσοδα, παραγγελίες, κέρδος, περιθώριο, μέση αξία) και κέρδος ανά κανάλι
explain_feed_product Γιατί ένα SKU είναι μέσα ή λείπει από το feed του Skroutz / Shopflix

Αλλαγές (token mcp + mcp:write)

Εργαλείο Τι κάνει
set_products_enabled Ενεργοποίηση / απενεργοποίηση προϊόντων στα feeds (με το όριο του πλάνου)
set_manual_price Σταθερή χειροκίνητη τιμή σε ένα προϊόν (και τις παραλλαγές του)
apply_price_change Εφαρμογή ή προγραμματισμός μαζικής αλλαγής τιμής (πρώτα preview_price_change)
advance_order_status Παραγγελία στο επόμενο βήμα (pending → processing → shipped → completed)
mark_order_shipped Αποστολή με courier και αριθμό αποστολής· στέλνονται και στο κανάλι της παραγγελίας
issue_invoice Έκδοση τιμολογίου myDATA ή απόδειξης λιανικής μέσω Oxygen. Μη αναστρέψιμο — λάθος παραστατικό θέλει πιστωτικό
update_stock Ορισμός του δικού σου αποθέματος ενός προϊόντος (καταγράφεται ως κίνηση)
toggle_supplier Ενεργοποίηση / απενεργοποίηση προμηθευτή (με το όριο του πλάνου)
rebuild_feed Νέα δημιουργία του αρχείου feed ενός καναλιού (στην ουρά)

Resources: syncore://catalog/summary (σύνοψη καταλόγου) και syncore://settings/summary (ρυθμίσεις και συνδεδεμένες υπηρεσίες, χωρίς secrets).

Επιβεβαίωση πριν από αλλαγές

  • Με token μόνο ανάγνωσης, τα εργαλεία αλλαγών δεν εμφανίζονται καν στον client· αν κληθούν, απορρίπτονται.
  • Τα εργαλεία αλλαγών δηλώνονται με readOnlyHint: false και (εκτός του rebuild_feed) destructiveHint: true, ώστε οι clients να ζητούν επιβεβαίωση από εσένα πριν τα εκτελέσουν. Μην ενεργοποιείς αυτόματη έγκριση για αυτά.
  • Ο server ζητά από το μοντέλο να κάνει πρώτα προεπισκόπηση στις μαζικές αλλαγές τιμών και να επιβεβαιώνει με τον χρήστη· το issue_invoice ζητά ρητή επιβεβαίωση.

Ιστορικό κλήσεων

Κάθε κλήση καταγράφεται. Στη σελίδα Σύνδεση AI (MCP) → Ιστορικό κλήσεων βλέπεις εργαλείο, παραμέτρους, αποτέλεσμα (Επιτυχία, Σφάλμα, Απορρίφθηκε) και token, με φίλτρα και αναζήτηση. Αν κάτι δεν το αναγνωρίζεις, ανακάλεσε το token από την ίδια σελίδα.