BizList.gr MCP Server

Τι ειναι το MCP;

Το Model Context Protocol (MCP) ειναι ενα ανοιχτο προτυπο που επιτρεπει σε AI agents να συνδεονται με εξωτερικα εργαλεια και πηγες δεδομενων. Αντι να κανετε copy-paste δεδομενα, το AI σας μπορει απευθειας να αναζητα εταιρειες, να βλεπει οικονομικα στοιχεια και να κανει αναλυση μεσω του BizList.gr.

Ο BizList MCP server δουλευει με καθε MCP-compatible client, συμπεριλαμβανομενων:

• claude.ai (Web, Desktop, Mobile) — μεσω OAuth, χωρις API key
• Claude Code (CLI)
• Cursor, Windsurf και αλλους AI-enabled editors
• Custom agents φτιαγμενοι με OpenAI Agents SDK, Anthropic SDK, LangGraph, κ.α.
• Καθε αλλο MCP client με Streamable HTTP transport

Γρηγορη συνδεση μεσω OAuth

Καθε MCP client που υποστηριζει OAuth 2.1 μπορει να συνδεθει χωρις ρυθμισεις — χωρις API key, χωρις manual setup. Ο server δημοσιευει το OAuth metadata στο /.well-known/oauth-authorization-server και υποστηριζει Dynamic Client Registration (RFC 7591), οποτε ο client καταχωρει τον εαυτο του αυτοματα την πρωτη φορα.

Παραδειγμα: claude.ai

1. Ανοιξτε το claude.ai
2. Πηγαινετε στο Settings → Connectors → Add custom connector
3. Επικολληστε το URL: https://api.bizlist.gr/mcp/v1
4. Πατηστε Connect
5. Θα ανακατευθυνθειτε στο bizlist.gr για συνδεση και εγκριση προσβασης
6. Ετοιμο — ολα τα εργαλεια διαθεσιμα στις συνομιλιες σας

Αλλοι OAuth-capable clients

Δωστε στο client το URL https://api.bizlist.gr/mcp/v1. Στο πρωτο request θα λαβει 401 με WWW-Authenticate header που δειχνει στο resource metadata. Απο εκει ο client ακολουθει την standard ροη OAuth 2.1 + PKCE ενωντας στον discovered authorization server. Δεν χρειαζεται προ-καταχωρηση client.

Ρυθμιση με API key

Για programmatic clients που δεν υποστηριζουν OAuth flow (background jobs, scripts, αρχεια ρυθμισεων του Claude Desktop κ.λπ.), χρησιμοποιειστε ενα long-lived API key:

1. Δημιουργηστε λογαριασμο η συνδεθειτε στο bizlist.gr
2. Πηγαινετε στη σελιδα Λογαριασμος
3. Μεταβειτε στα "API Keys" και δημιουργηστε ενα νεο κλειδι
4. Αντιγραψτε το κλειδι αμεσως (δεν θα εμφανιστει ξανα)
5. Αγοραστε API credits για χρηση με τα MCP εργαλεια

Ρυθμιση

Claude Desktop

Προσθεστε τα παρακατω στο αρχειο ρυθμισεων του Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bizlist": {
      "type": "streamable-http",
      "url": "https://api.bizlist.gr/mcp/v1",
      "headers": {
        "X-Api-Key": "TO_API_KEY_SAS"
      }
    }
  }
}

Claude Code (CLI)

Εκτελεστε αυτη την εντολη στο terminal:

claude mcp add-json bizlist '{
  "type": "http",
  "url": "https://api.bizlist.gr/mcp/v1",
  "headers": {
    "X-Api-Key": "TO_API_KEY_SAS"
  }
}' --scope user

Cursor / Αλλοι MCP Clients

Χρησιμοποιηστε τα παρακατω στοιχεια συνδεσης:

Διαθεσιμα εργαλεια

Ο MCP server παρεχει 12 εργαλεια που μπορει να χρησιμοποιησει ο AI assistant σας:

Credits & τιμολογηση

Οι κλησεις MCP εργαλειων χρησιμοποιουν το ιδιο συστημα credits με το REST API:

Αγοραστε credits στη σελιδα Credits.

Παραδειγματα χρησης

Μολις ρυθμισετε τη συνδεση, απλα ρωτηστε τον AI assistant σας φυσικα:

"Θελω να ανοιξω σουβλατζιδικο στην οδο Ερμου στην Αθηνα.
Τι ανταγωνισμο εχω; Ποσα εστιατορια υπαρχουν
στην περιοχη και ποια ειναι τα οικονομικα τους;"

"Βρες ολες τις ενεργες εταιρειες λογισμικου στη Θεσσαλονικη
που εχουν email. Θελω τα στοιχεια επικοινωνιας τους."

"Ψαξε την εταιρεια με ΑΦΜ 123456789.
Ποιοι ειναι οι μετοχοι; Ποια ειναι η πορεια των εσοδων;"

"Αναλυσε τα οικονομικα εγγραφα της εταιρειας 170000000000
για τα τελευταια 3 χρονια. Συγκρινε εσοδα και κερδοφορια."