Narzędzia i zasoby MCP

search_tools, execute_tool, prośby o uprawnienia, zadania w tle, pliki i umiejętności jako zasoby MCP.

Na tej stronie

Serwer MCP Hypris wystawia kilka narzędzi, które są zawsze dostępne. Wszystkie pozostałe operacje asystent znajduje przez search_tools i uruchamia przez execute_tool. Ich pełną listę, z nazwami narzędzi i schematami wejścia, znajdziesz w katalogu endpointów i narzędzi.

Narzędzia stałe

Narzędzie	Do czego służy
`search_tools`	Wyszukuje operacje w katalogu i zwraca ich nazwy oraz schematy wejścia
`execute_tool`	Uruchamia operację znalezioną przez `search_tools`
`create_permission_request`	Prosi administratora workspace o brakujące uprawnienie
`get_job`	Sprawdza status zadania w tle po `jobId`
`read_file`	Odczytuje treść pliku
`create_file_upload_link`	Tworzy link do przesłania pliku
`confirm_file_upload`	Potwierdza przesłanie pliku
`create_file_download_link`	Tworzy link do pobrania pliku

Wyszukiwanie narzędzi

search_tools przyjmuje opis zadania i zwraca najlepiej pasujące operacje:

search_tools, wejście

{
  "query": "utwórz rekord w bazie danych",
  "topK": 10
}

topK to liczba wyników od 1 do 40, domyślnie 10. Wyszukiwanie działa po znaczeniu, więc nie musisz znać dokładnej nazwy narzędzia, wystarczy opis tego, co chcesz zrobić.

Uruchamianie narzędzi

execute_tool przyjmuje nazwę narzędzia i jego argumenty, zgodnie ze schematem zwróconym przez search_tools:

execute_tool, wejście

{
  "toolName": "get_database_property_possible_values",
  "arguments": {
    "params": {"databasePropertyId": "65a1f0c2b3d4e5f601234567"}
  }
}

Argumenty mają te same części co zapytanie HTTP: params dla ścieżki, query dla parametrów adresu i body dla treści. Wielkość liter w nazwie narzędzia nie ma znaczenia.

Prośby o uprawnienia

Gdy asystentowi brakuje dostępu, może poprosić o niego administratora:

create_permission_request, wejście

{
  "workspaceId": "<id workspace>",
  "resourceType": "database",
  "resourceId": "<id bazy>",
  "permissionType": "database.item.create",
  "note": "Chcę dodawać leady z formularza kontaktowego."
}

Narzędzie czeka do 60 sekund na decyzję administratora, więc jeśli ten jest pod ręką, asystent może od razu kontynuować. Administrator widzi prośbę w ustawieniach workspace, w sekcji Prośby o uprawnienia.

Zadania w tle

Część operacji, na przykład aktualizacja wartości rekordu, kończy się w tle i zwraca jobId. get_job zwraca status running, completed albo failed, postęp, wynik i powód błędu. Zadanie odczyta tylko ten, kto je utworzył.

Pliki

Przesyłanie i pobieranie plików nie idzie przez kontekst modelu. Narzędzia tworzą do tego osobne linki:

create_file_upload_link zwraca adres, pod który klient przesyła plik.
confirm_file_upload kończy przesyłanie i podpina plik tam, gdzie miał trafić.
create_file_download_link zwraca adres do pobrania pliku.
read_file odczytuje treść pliku, gdy asystent ma ją przeanalizować.

Umiejętności jako zasoby

Opublikowane umiejętności workspace są dostępne jako zasoby MCP, więc asystent może je przeczytać i zastosować:

Adres zasobu	Zawartość
`skill://index.json`	Spis dostępnych umiejętności
`skill://{workspace}/{skill}/SKILL.md`	Treść jednej umiejętności

Serwer udostępnia do 200 umiejętności. Hypris nie rejestruje promptów MCP.

Błędy narzędzi

Gdy operacja się nie powiedzie, na przykład z braku uprawnień, narzędzie zwraca wynik z isError: true i opisem błędu. Asystent widzi go jak każdą odpowiedź i może zareagować, na przykład wysłać prośbę o uprawnienie. Błędy protokołu, takie jak zły token, przychodzą jako błędy JSON-RPC.