# kChat MCP Server
MCP Server for the kChat API.
## Tools
1. `kchat_list_channels`
- List public channels
- Optional inputs:
- `limit` (number, default: 100, max: 200): Maximum number of channels to return
- `page` (number, default: 0): Pagination page
- Returns: List of channels with their IDs and information
2. `kchat_post_message`
- Post a new message to a kChat channel
- Required inputs:
- `channel_id` (string): The ID of the channel to post to
- `text` (string): The message text to post
- Returns: Message post
3. `kchat_reply_to_thread`
- Reply to a specific message thread
- Required inputs:
- `channel_id` (string): The channel containing the thread
- `thread_id` (string): The parent message ID
- `text` (string): The reply text
- Returns: Message post
4. `kchat_add_reaction`
- Add an emoji reaction to a message
- Required inputs:
- `post_id` (string): The message ID
- `reaction` (string): Emoji name without colons
- Returns: Reaction
5. `kchat_get_channel_history`
- Get recent messages from a channel
- Required inputs:
- `channel_id` (string): The channel ID
- Optional inputs:
- `limit` (number, default: 10): Number of messages to retrieve
- Returns: List of messages with their content and metadata
6. `kchat_get_thread_replies`
- Get all replies in a message thread
- Required inputs:
- `thread_id` (string): The parent message ID
- Returns: List of replies with their content and metadata
7. `kchat_get_users`
- Get list of workspace users with basic profile information
- Optional inputs:
- `limit` (number, default: 100, max: 100): Maximum number of users to return
- `page` (number, default: 0): Pagination page
- Returns: List of users with their basic profiles
8. `kchat_get_user_profile`
- Get detailed profile information for a specific user
- Required inputs:
- `user_id` (string): The user's ID
- Returns: Detailed user profile information
9. `kchat_send_direct_message`
- Send a direct message to a user by username
- Required inputs:
- `username` (string): The username of the user to send the message to
- `text` (string): The message text to send
- Returns: Message post
## Setup
1. Create a kChat token linked to your user:
- Visit the [API Token page](https://manager.infomaniak.com/v3/ng/accounts/token/list)
- Choose "kChat" scope
Create a kChat token linked to a bot:
- Visit your kChat webapp and click on New > Integrations > Bot accounts > Add bot accounts
2. Get your kChat team name from your kChat url (eg. https://your-team.kchat.infomaniak.com/your-team/channels/town-square url have `your-team` team)
### Usage with Claude Desktop
Add the following to your `claude_desktop_config.json`:
#### NPX
```json
{
"mcpServers": {
"kchat": {
"command": "npx",
"args": [
"-y",
"@infomaniak/mcp-server-kchat"
],
"env": {
"KCHAT_TOKEN": "your-token",
"KCHAT_TEAM_NAME": "your-team"
}
}
}
}
```
#### docker
```json
{
"mcpServers": {
"kchat": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KCHAT_TOKEN",
"-e",
"KCHAT_TEAM_NAME",
"infomaniak/mcp-server-kchat"
],
"env": {
"KCHAT_TOKEN": "your-token",
"KCHAT_TEAM_NAME": "your-team"
}
}
}
}
```
### Environment Variables
1. `KCHAT_TOKEN`: Required. Your kChat token.
2. `KCHAT_TEAM_NAME`: Required. Your kChat team unique name.
### Troubleshooting
If you encounter permission errors, verify that:
1. All required scopes are added to your kChat token
2. The token and team name are correctly copied to your configuration
## Build
Docker build:
```bash
docker build -t infomaniak/mcp-server-kchat -f Dockerfile .
```
## License
This MCP server is licensed under the MIT License.
