MCP Server
Connect AI chat clients such as Claude or ChatGPT to facilioo and work with processes, inquiries and documents in a conversation
ExperimentalThe facilioo MCP server is experimental. Its tools, their parameters and their responses may change or be removed at any time without prior notice, and there is no availability guarantee. We are happy about feedback in our Discussions.
The facilioo MCP server makes facilioo data available to AI chat clients via the Model Context Protocol (MCP). Once connected, you can ask questions about your data in natural language, for example to summarize the history of a process, find the documents of a property or get an overview of the open inquiries of a unit.
The MCP server only provides the data. Understanding the question, choosing the tools and writing the answer is done by the AI model of your chat client.
Specification
| Property | Value |
|---|---|
| Transport | Streamable HTTP |
| Authentication | OAuth 2.1 with PKCE (S256) and dynamic client registration |
| Tools | Read-only |
| Allowed accounts | Accounts of property management companies |
Environments
| Name | MCP Server URL | Data from |
|---|---|---|
| Production | https://mcp.facilioo.de/mcp | https://api.facilioo.de/api/ |
| Staging | https://stage-mcp.facilioo.de/mcp | https://stage-api.facilioo.de/api/ |
Staging works with the same accounts and has the same limitations as the API, see Environments. Use it to try the MCP server with real data without working on the current production data.
Read-Only Tools
All tools of the MCP server only search and read data. None of them creates, changes or deletes anything in facilioo, so the AI model can't send messages, change a process or share a document through them.
To call the tools, the chat client receives an access token of the signed-in account when connecting. Only connect chat clients you trust, and remove the connector when you no longer use it.
Who Can Use It
The MCP server can only be used with accounts of property management companies. Sign-ins with other accounts, such as those of residents or contractors, are rejected.
Every request runs in the context of the signed-in account. The AI model therefore sees exactly the data this account can see on the facilioo platform, and nothing more.
Data Processing by the Chat ClientData the AI model retrieves through the MCP server is passed on to the provider of your chat client and processed there. Make sure that using the chat client with this data is in line with your data protection requirements, e.g. your data processing agreement with the provider.
Connecting a Chat Client
Any chat client that supports remote MCP servers with OAuth can connect to facilioo, e.g. Claude, ChatGPT or other MCP-capable clients. Add a custom connector (in some clients also called app, integration or MCP server) with the following URL:
https://mcp.facilioo.de/mcpYou don't need to enter a client ID or client secret, the chat client registers itself automatically. When connecting, the chat client opens a facilioo login page on mcp.facilioo.de, which shows the name of the chat client and the host you will be redirected to after signing in. Check both, then sign in with your facilioo credentials to grant access.
Claude
- Open Settings → Connectors in Claude.
- Select Add custom connector.
- Enter a name, e.g.
facilioo, and the URLhttps://mcp.facilioo.de/mcp. - Select Connect and sign in with your facilioo credentials.
The connector is then available in claude.ai, Claude Desktop and the Claude mobile apps.
ChatGPT and Other Clients
The steps differ by client and plan, and some clients only allow custom connectors in certain plans or after enabling a developer mode. Refer to the documentation of your chat client on how to add a remote MCP server, and use the URL above.
Disconnecting
You can remove the connector in your chat client at any time. If the connection stops working, e.g. after you changed your password, remove the connector and add it again.
Tools
The tools are grouped by the data they read. Search tools are paginated and return at most 50 results per page.
Master Data
| Tool | Purpose |
|---|---|
search_properties | Find a property by name, number, street or city |
search_units | Find a unit by its number, optionally within a property |
search_parties | Find a person or company by name, optionally filtered by role |
search_contracts | Find the unit contracts that link a party to its unit and property |
Processes
| Tool | Purpose |
|---|---|
search_processes | Search processes by number, subject and report, with filters |
get_process | Read a process including its full report |
get_process_feed | Read the timeline of a process, e.g. to summarize it |
list_process_types | List the process types |
Inquiries
| Tool | Purpose |
|---|---|
search_inquiries | Search received inquiries, filtered by property, unit, party or creation date |
get_inquiry | Read an inquiry including its full report and response |
list_inquiry_categories | List the inquiry categories |
Documents
| Tool | Purpose |
|---|---|
search_documents | Search documents by title and description |
get_document | Read the details of a document |
get_document_file | Read the file of a document |
list_document_groups | Navigate the document folders |
search_document_shares | List the parties a document is shared with, or the documents shared with a party |
Limitations
search_documentsonly searches the title and description of documents, not the content of their files.get_document_filecan only read files up to 10 MB.- Sign-ins are rate limited per IP address, including successful ones. If many people connect from the same network at the same time, wait a minute and try again.
- How well a question is answered depends on the AI model and chat client. Verify important answers on the facilioo platform.
Feedback and Help
Questions, feedback and feature requests are welcome in our Discussions. For everything else, see Getting Help.
Updated about 1 hour ago
