Plugin του ChatGPT και MCP
Εταιρικά δεδομένα απευθείας στο ChatGPT, στο Claude και σε άλλους πράκτορες AI.
Με το Plugin του ChatGPT και τον διακομιστή MCP, ο πράκτορας AI σου αναζητά μόνος του επίσημα εταιρικά δεδομένα. Κάνεις μια ερώτηση στη συνομιλία, ο πράκτορας επιλέγει τα κατάλληλα εργαλεία και απαντά με δεδομένα από το μητρώο.
Plugin του ChatGPT
Το Plugin του ChatGPT είναι ο γρηγορότερος τρόπος. Δεν χρειάζεσαι κλειδί API, γιατί συνδέεσαι με τον λογαριασμό σου στο handelsregister.ai κατά τη σύνδεση.
- Άνοιξε το Plugin του ChatGPT και πρόσθεσέ το στο ChatGPT.
- Συνδέσου με τον λογαριασμό σου στο handelsregister.ai και επιβεβαίωσε την πρόσβαση.
- Κάνε την ερώτησή σου, για παράδειγμα «Ποιος διοικεί τη Hetzner Online GmbH και πώς εξελίχθηκε ο κύκλος εργασιών της;»
Claude, Cursor και άλλοι πελάτες MCP
Το MCP, το Model Context Protocol, είναι ένα ανοιχτό πρότυπο μέσω του οποίου οι πράκτορες AI έχουν πρόσβαση σε εργαλεία και πηγές δεδομένων. Κάθε client που συνδέεται σε διακομιστή MCP μέσω URL μπορεί να χρησιμοποιήσει τον διακομιστή μας.
| Τι | Τιμή |
|---|---|
| URL διακομιστή |
https://mcp.handelsregister.ai/mcp |
| Μεταφορά | Streamable HTTP |
| Σύνδεση | OAuth με τον λογαριασμό σου, κλειδί API στο header x-api-key ή bearer token στο header Authorization |
Claude
Στο Claude, προσθέτεις τον διακομιστή MCP ως custom connector. Στις ρυθμίσεις των connectors, επίλεξε «Add custom connector», δώσε ένα όνομα και το URL του διακομιστή και συνδέσου με τον λογαριασμό σου στο handelsregister.ai. Στη συνέχεια ενεργοποίησε τον connector στη συνομιλία μέσω «+» › «Connectors».
Σε workspaces Team και Enterprise, ένας owner προσθέτει τον connector για όλους. Κάθε μέλος συνδέει στη συνέχεια τον δικό του λογαριασμό στο handelsregister.ai.
Claude Code
Στο Claude Code, προσθέτεις τον διακομιστή με μία εντολή. Με το header, το Claude Code χρησιμοποιεί το κλειδί API σου.
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: YOUR_API_KEY"
Χωρίς το header, συνδέεσαι αντί γι’ αυτό στον browser: ξεκίνα μια συνεδρία και επίλεξε τον διακομιστή στο /mcp.
Cursor
Το Cursor διαβάζει διακομιστές MCP από το .cursor/mcp.json στο project ή από το ~/.cursor/mcp.json για όλα τα projects. Πολλοί άλλοι clients χρησιμοποιούν την ίδια μορφή.
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "YOUR_API_KEY" } } } }
Άλλοι πελάτες MCP
Δώσε το URL του διακομιστή και στείλε το κλειδί API σου στο header x-api-key με κάθε αίτημα. Εναλλακτικά, χρησιμοποίησε ένα bearer token στο header Authorization· η Αυθεντικοποίηση δείχνει πώς δημιουργείς ένα.
Διαθέσιμα εργαλεία
Ο διακομιστής MCP προσφέρει εργαλεία για τον λογαριασμό σου, προφίλ εταιρειών, πρόσωπα, έγγραφα, αναζήτηση και Signals. Όλα τα εργαλεία μόνο διαβάζουν: δεν δημιουργούν τίποτα και δεν αλλάζουν ρυθμίσεις. Κοστίζουν τόσες πιστώσεις όσες και το ίδιο αίτημα στο API.
Τα εργαλεία εταιρειών δέχονται στην παράμετρο q ένα entity_id, μια επωνυμία ή δικαστήριο μητρώου με αριθμό μητρώου, για παράδειγμα «Ansbach HRB 6089». Το entity_id από μια αναζήτηση είναι το πιο αξιόπιστο. Στα περισσότερα εργαλεία εταιρειών, το ai_search ενεργοποιεί τη Λειτουργία AI και το realtime τον Πραγματικό χρόνο.
Λογαριασμός
| Εργαλείο | Τι επιστρέφει | Πιστώσεις |
|---|---|---|
| get_account_status | Πλάνο, υπόλοιπο, επόμενη λήξη πιστώσεων και τα δεδομένα που ξεκλειδώνει το πλάνο σου. | δωρεάν |
Προφίλ εταιρείας
Κάθε εργαλείο εταιρείας κοστίζει τη βασική τιμή του προφίλ εταιρείας συν την τιμή του feature του, όπως ακριβώς το fetch-organization. Το feature χρεώνεται μόνο όταν επιστρέφει δεδομένα.
| Εργαλείο | Τι επιστρέφει | Πιστώσεις |
|---|---|---|
| get_company_overview | Τα βασικά στοιχεία: επωνυμία, κατάσταση, νομική μορφή, μητρώο, διεύθυνση, κεφάλαιο, σκοπός και κλάδος. | 5 |
| get_company_snapshot | Βασικά στοιχεία, Οικονομικοί δείκτες και η τρέχουσα διοίκηση σε μία κλήση. | 5 + 1 + 2 |
| get_financials | Οικονομικοί δείκτες ανά οικονομικό έτος, όπως κύκλος εργασιών, καθαρό αποτέλεσμα και εργαζόμενοι. | 5 + 1 |
| get_balance_sheet | Ο ισολογισμός με όλα τα κονδύλια. | 5 + 3 |
| get_profit_and_loss | Η κατάσταση αποτελεσμάτων χρήσης. | 5 + 3 |
| get_annual_financial_statements | Ετήσιες οικονομικές καταστάσεις σε πλήρες κείμενο ως Markdown. | 5 + 5 |
| get_annual_financial_statements_html | Ετήσιες οικονομικές καταστάσεις σε πλήρες κείμενο ως HTML. | 5 + 5 |
| get_related_persons | Η διοίκηση και άλλα εγγεγραμμένα πρόσωπα, και τα πρώην αν τα ζητήσεις. | 5 + 2 |
| get_shareholders | Οι εταίροι με τα μερίδιά τους. | 5 + 5 |
| get_ubos | Οι πραγματικοί δικαιούχοι (UBO). | 5 + 10 |
| get_shareholdings | Οι συμμετοχές της εταιρείας σε άλλες εταιρείες. | 5 + 5 |
| get_mergers_and_acquisitions | Συγχωνεύσεις & εξαγορές (M&A) και συμβάσεις επιχείρησης. | 5 + 20 |
| get_publications | Το ιστορικό ανακοινώσεων μητρώου. | 5 + 1 |
| get_insolvency_publications | Ανακοινώσεις αφερεγγυότητας. | 5 + 5 |
| get_news | Ειδήσεις για την εταιρεία από το διαδίκτυο. | 5 + 10 |
| get_website_content | Το περιεχόμενο της ιστοσελίδας της εταιρείας ως Markdown. Αυτό το εργαλείο χρησιμοποιεί πάντα τη Λειτουργία AI. | 5 + 20 (Λειτουργία AI) |
| get_company_features | Πολλά features σε μία κλήση, με μία μόνο βασική τιμή. | 5 + features |
Πρόσωπα και έγγραφα
| Εργαλείο | Τι επιστρέφει | Πιστώσεις |
|---|---|---|
| fetch_person | Το προφίλ προσώπου: θέσεις, συμμετοχές και επαγγελματική πορεία ενός προσώπου, με αναζήτηση βάσει ονόματος και μιας σχετικής εταιρείας. · από Plus | 15, με shareholdings + 5 |
| fetch_document | Ένα έγγραφο από το μητρώο: Aktueller Abdruck (AD, τρέχον απόσπασμα), Chronologischer Abdruck (CD, χρονολογικό απόσπασμα), Strukturierter Registerinhalt (SI, δομημένο περιεχόμενο μητρώου), Gesellschafterliste (λίστα εταίρων) ή καταστατικό. | 15 |
Αναζήτηση
Τα εργαλεία αναζήτησης επιστρέφουν έως 30 αποτελέσματα ανά σελίδα, το καθένα με το entity_id του. Ο πράκτοράς σου το χρησιμοποιεί στη συνέχεια για να ανακτήσει το προφίλ εταιρείας.
| Εργαλείο | Τι επιστρέφει | Πιστώσεις |
|---|---|---|
| search_organizations | Εύρεση εταιρειών με επωνυμία ή φίλτρα. | 1 ανά σελίδα |
| search_organizations_advanced | Αναζήτηση με όλα τα φίλτρα του API και ταξινόμηση, για παράδειγμα κατά κύκλο εργασιών ή ημερομηνία ίδρυσης. | 1 ανά σελίδα |
| find_companies_by_industry | Εταιρείες ενός κλάδου, περιγραμμένου με λόγια ή ως κωδικός WZ. | 1 ανά σελίδα |
| find_companies_by_financials | Εταιρείες με βάση κύκλο εργασιών, εργαζομένους, καθαρό αποτέλεσμα, ίδια κεφάλαια και άλλους δείκτες. | 1 ανά σελίδα |
| find_companies_near | Εταιρείες γύρω από μια τοποθεσία, οι πλησιέστερες πρώτες. | 1 ανά σελίδα |
| find_newly_registered_companies | Νεοεγγεγραμμένες εταιρείες σε μια περίοδο. | 1 ανά σελίδα |
| find_recently_changed_companies | Εταιρείες με πρόσφατες μεταβολές, για παράδειγμα στη διοίκηση, την καταστατική έδρα ή το κεφάλαιο. | 1 ανά σελίδα |
| find_related_companies | Συνδεδεμένες εταιρείες μέσω συμμετοχών, θέσεων, συγχωνεύσεων ή συμβάσεων επιχείρησης. | 1 ανά σελίδα |
| find_companies_by_person | Εταιρείες στις οποίες ένα πρόσωπο κατέχει θέση. Η αναζήτηση ανά εταίρο είναι διαθέσιμη με Pro και Max. | 1 ανά σελίδα |
| find_companies_by_ownership | Εταιρείες με βάση τη δομή ιδιοκτησίας, για παράδειγμα με διαχείριση από τον ιδιοκτήτη ή οικογενειακές. · Pro, Max | 1 ανά σελίδα |
| find_companies_by_management | Εταιρείες με βάση την ηλικία και το μέγεθος της διοίκησης. · Pro, Max | 1 ανά σελίδα |
| find_companies_in_insolvency | Εταιρείες σε διαδικασία αφερεγγυότητας, ανά φάση και περίοδο. · Pro, Max | 1 ανά σελίδα |
| get_search_filter_reference | Οι επιτρεπτές τιμές των φίλτρων αναζήτησης. | δωρεάν |
| find_industry_codes | Κωδικοί WZ για έναν κλάδο περιγραμμένο με λόγια, για παράδειγμα «ανάπτυξη λογισμικού». | δωρεάν |
Signals
Τα εργαλεία Signals επιστρέφουν μεταβολές στο μητρώο σε όλες τις εταιρείες, έως 20 ανά σελίδα. Μια σελίδα χρεώνεται ακόμη και όταν είναι κενή.
| Εργαλείο | Τι επιστρέφει | Πιστώσεις |
|---|---|---|
| get_recent_new_registrations | Νέες καταχωρίσεις. | 20 ανά σελίδα |
| get_recent_management_changes | Αλλαγές διοίκησης. | 20 ανά σελίδα |
| get_recent_capital_changes | Μεταβολές κεφαλαίου. | 20 ανά σελίδα |
| get_recent_master_data_changes | Μεταβολές βασικών στοιχείων όπως επωνυμία, καταστατική έδρα ή διεύθυνση. | 20 ανά σελίδα |
| get_recent_company_closures | Διαγραφές & λύσεις. | 20 ανά σελίδα |
| get_recent_insolvency_events | Αφερεγγυότητες. · Pro, Max | 20 ανά σελίδα |
| get_recent_mergers_and_transformations | Μετασχηματισμοί & M&A. · Max | 20 ανά σελίδα |
| get_recent_company_changes | Όλες οι μεταβολές για έως πέντε συγκεκριμένες εταιρείες. | 20 ανά σελίδα |
| get_signal_details | Ένα μεμονωμένο signal με όλες τις λεπτομέρειες. | 20 |
Κόστος
Κάθε κλήση εργαλείου κοστίζει τόσες πιστώσεις όσες και το ίδιο αίτημα στο API. Δεν υπάρχει ξεχωριστή χρέωση για το MCP. Οι πιστώσεις αφαιρούνται από τον λογαριασμό με τον οποίο συνδέθηκες ή στον οποίο ανήκει το κλειδί API.
Ισχύουν οι ίδιοι κανόνες όπως στο API: features χωρίς δεδομένα δεν κοστίζουν τίποτα, και μια αποτυχημένη κλήση δεν κοστίζει τίποτα. Η Λειτουργία AI χρεώνεται ακόμη και χωρίς αποτέλεσμα, ο Πραγματικός χρόνος για κάθε επιτυχή ζωντανή ανάκτηση. Κάθε αποτέλεσμα αναφέρει τις πιστώσεις που χρεώθηκαν στο meta.request_credit_cost και το υπόλοιπό σου στο meta.credits_remaining.
Και τα όρια είναι ίδια με του API, για τα έγγραφα για παράδειγμα 5 αιτήματα ανά λεπτό. Περισσότερα στη Χρέωση και στα Όρια.