khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2026-01-02 17:59:36 +07:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #13491 from nextcloud/feat/mcp

Browse Source 
feat: mcp server docs
This commit is contained in:
rakekniven
2025-08-08 07:50:36 +02:00
committed by GitHub
parent 706c27ccde c0eac95e1e
commit 4fd1d1ddb3
1 changed files with 26 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
admin_manual/ai/app_context_agent.rst
View File

@@ -143,6 +143,21 @@ These tools can also be combined by the agent to fulfil tasks like the following
* Uses contacts to look up Andrew's email and then sends an email
Custom Tools using MCP
-----------------------
Model Context Protocol (MCP) is a protocol that enables Large Language Models (LLMs) to interact with external data sources and tools.
The Context Agent app allows administrators to extend its capabilities by adding custom services via MCP. This can be configured in the admin settings under "MCP Config," where you can provide a JSON configuration in the following format:
.. code-block:: json
{
"service-name": {
"url": "https://service-url.com/endpoint",
"transport": "streamable_http"
}
}
Requirements
------------
@@ -176,6 +191,13 @@ Other models that may give good results are:
See :ref:`llm2 documentation <ai-app-llm2>` on how to configure alternate models.
Using Nextcloud MCP Server
--------------------------
Context Agent exposes an MCP server that can be used by other large language models or applications to access the tools provided by Context Agent.
The server will be available at `https://your-nextcloud-domain.com/index.php/apps/app_api/proxy/context_agent/mcp/`, and
it requires authentication via an app password passed in the `Authorization` header. Ex: `Authorization: Bearer <app-password>`.
Scaling
-------
@@ -198,4 +220,7 @@ Known Limitations
* Make sure to test the language model you are using in concert with this app for whether they meet the use-case's quality requirements
* Most models have difficulties with languages other than English. Some sometimes answer in another language than used by the user.
* Customer support is available upon request, however we can't solve false or problematic output, most performance issues, or other problems caused by the underlying model.
Support is thus limited only to bugs directly caused by the implementation of the app (connectors, API, front-end, AppAPI). We still try to optimize this as far as possible, so if you encounter any false or problematic output, you can report it `in a dedicated Github issue <https://github.com/nextcloud/context_agent/issues/51>`_ to help us improve this app.
Support is thus limited only to bugs directly caused by the implementation of the app (connectors, API, front-end, AppAPI). We still try to optimize this as far as possible, so if you encounter any false or problematic output, you can report it `in a dedicated Github issue <https://github.com/nextcloud/context_agent/issues/51>`_ to help us improve this app.
* When multiple MCP services are configured that have tools with the same name undefined behavior will occur.
* Only remote MCP services are supported (streamable_http transport).
* MCP services that require different access tokens for each user are not currently supported.