Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SSL_VERIFY | No | Enable/disable SSL verification for API calls. Set to 'false' to disable. Defaults to 'true'. | true |
| TOPDESK_URL | Yes | The base URL of your Topdesk instance. e.g. `https://yourcompany.topdesk.net` | |
| OPENAI_API_KEY | No | API key for OpenAI API authentication | |
| DOCLING_ADDRESS | No | URL of a Docling API server for document conversion. e.g. `http://localhost:8080` | |
| DOCLING_API_KEY | No | API key for Docling API authentication | |
| OPENAI_API_BASE | No | Base URL for OpenAI-compatible API for document conversion. e.g. `https://api.openai.com` | |
| DOCLING_PASSWORD | No | Password for Docling API basic authentication (fallback if no API key) | |
| DOCLING_USERNAME | No | Username for Docling API basic authentication (fallback if no API key) | |
| TOPDESK_MCP_HOST | No | The host to listen on (for 'streamable-http' and 'sse'). Defaults to '0.0.0.0'. | 0.0.0.0 |
| TOPDESK_MCP_PORT | No | The port to listen on (for 'streamable-http' and 'sse'). Defaults to '3030'. | 3030 |
| TOPDESK_PASSWORD | Yes | Your API token | |
| TOPDESK_USERNAME | Yes | The username you generated the API token against. | |
| OPENAI_MODEL_NAME | No | Model name to use for OpenAI API calls. Defaults to 'gpt-4.1' | gpt-4.1 |
| TOPDESK_MCP_TRANSPORT | No | The transport to use: 'stdio', 'streamable-http', 'sse'. Defaults to 'stdio'. | stdio |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |