Staffbase MCP Server Tools and Troubleshooting

Explore the tools exposed by the Staffbase MCP Server and troubleshoot common connection issues.

Employee App
Staffbase Intranet

The Staffbase MCP Server allows to read content from the Staffbase platform on behalf of a signed-in user. It implements the Model Context Protocol, an open standard that defines how an AI agent discovers and calls tools on a remote server.

MCP Server supports the following read-only tools:

Tool Purpose Returns
who_am_i Identify the authenticated user. The profile information of the signed-in user.
search Search Staffbase content. Matching News, Pages, and User Profiles that the user can access.
find_media Find media content. Media items that the user can access.
get_media_download_url Retrieve the download URL for a media item. A download URL for media the user can access.
inspect_media Retrieve metadata for a media item. Metadata for a media item the user can access, such as format, size, and so on.

Search returns results ranked by relevance only and provides content snippets rather than searching within or returning content from the dedicated page.

Use the following table to diagnose common connection and authentication issues.

Issue Possible Cause Resolution
Authorization fails with 401 or 400. The managed OAuth client is missing, or is not named MCP. Verify the OAuth client name is MCP, and the client type is SPA.
Authorization flow does not start. OAuth is not configured. Ensure OAuth is activated for your platform and configure the OAuth client access.
Login succeeds, but the redirect fails. The AI client’s callback URL is not registered. Add the exact redirect URI to the OAuth client configuration.
The browser client reports a CORS error. The client origin is not allowlisted. Add the origin to Allowed CORS Origins in the OAuth client configuration.
Search returns few or no results. Search results are limited to the authenticated user’s permissions and currently include only news, pages, and user profile information. Sign in as a user with access to the content you expect.