Dostęp do API i MCP

Dostęp do API i MCP

Metricgram udostępnia publiczne API oraz serwer MCP, aby podłączać Twoje własne narzędzia, panele, automatyzacje lub klientów AI do danych i operacji dostępnych na Twoim koncie.

Serwer MCP jest dostępny w każdym płatnym planie oraz w 14-dniowym okresie próbnym. Klienci AI mogą łączyć się przez OAuth (wystarczy wkleić adres URL serwera i zatwierdzić dostęp) lub za pomocą klucza API. REST API wymaga dostępu Elite. Jeśli Twoje konto go nie obejmuje, sekcja API może być zablokowana lub pokazywać komunikat o konieczności podniesienia planu.

Gdzie to znaleźć

Otwórz Integracje > MCP lub Integracje > API w panelu menedżera. Stamtąd konta z dostępem mogą tworzyć tokeny API, przeglądać aktywne tokeny, unieważniać tokeny oraz zobaczyć dokumentację techniczną dostępną dla ich planu.

Jak działają tokeny

• Tokeny należą do Twojego konta użytkownika Metricgram, a nie do pojedynczej grupy.
• Token może uzyskiwać dostęp do grup i zasobów, którymi może zarządzać Twoje konto.
• Tokeny obejmują zakresy uprawnień dla obszarów takich jak grupy, członkowie, wiadomości, automatyzacje, subskrybenci, analityka, zgłoszenia do pomocy technicznej, polecenia i MCP.
• Niektóre punkty końcowe odczytują dane; inne mogą tworzyć, aktualizować, moderować lub wyzwalać akcje w zależności od uprawnień tokenu.
• Wartość tokenu jest pokazywana tylko raz, podczas tworzenia. Przechowuj ją bezpiecznie.

Telegram Bot API przez MCP

Serwer MCP udostępnia też Telegram Bot API ograniczone do Twoich grup, dzięki czemu agenci AI mogą działać w Twoich grupach przez bota Metricgram lub Twojego własnego bota.

• Użyj telegram_api_methods, aby wyświetlić metody, które może wywołać Twój token, oraz telegram_bot_api, aby wywołać dowolną z nich z oficjalnymi parametrami Bot API.
• Typowane narzędzia obsługują codzienną pracę: send_telegram_message, send_telegram_media, send_telegram_poll, pin_telegram_message, manage_forum_topic, create_telegram_invite_link i inne.
• Czat to zawsze jedna z Twoich grup. Nigdy nie przekazujesz chat_id; Metricgram wyznacza go na podstawie group_id.
• Akcje w Telegramie mają własne uprawnienia: telegram:read, telegram:write, telegram:moderate i telegram:admin. Tokeny utworzone przed wprowadzeniem tych uprawnień trzeba utworzyć ponownie, aby z nich korzystać.
• Multimedia muszą być publicznym adresem URL HTTPS lub identyfikatorem file_id z Telegrama, a przyciski inline mogą tylko otwierać adresy URL lub kopiować tekst.
• Narzędzia zapisujące przyjmują opcjonalny idempotency_key, więc ponowione wywołanie nie wykona akcji dwa razy.

Uwierzytelnianie i limity

Żądania API używają nagłówka Authorization: Bearer mg_.... Domyślny limit to 600 żądań na minutę dla każdego tokenu, a formularz tokenu pozwala wybrać wartość pomiędzy minimum a maksimum dozwolonym przez aplikację.

Jeśli token zostanie unieważniony, konto użytkownika utraci dostęp do API albo konto nie będzie już miało planu z dostępem do API, żądania używające tego tokenu będą odrzucane.

Dobre praktyki

• Twórz osobne tokeny dla różnych narzędzi zewnętrznych.
• Używaj jasnych nazw, aby móc rozpoznać, gdzie używany jest każdy token.
• Unieważniaj tokeny, których już nie potrzebujesz.
• Nie udostępniaj tokenów w czatach, zrzutach ekranu, zgłoszeniach ani publicznych repozytoriach.