ovice MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ovice MCP Server send a notification to the 'Engineering' workspace saying the deployment is complete"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ovice MCP Server
このリポジトリについて
ローカル環境でMCPサーバーを構築する個人的な検証のための非公式なリポジトリです(動作保証いたしかねます)
ovice API と連携し、ワークスペース、グループ、ユーザー管理や通知機能を提供するMCPサーバーです。
Related MCP server: ServiceNow MCP Server
機能概要
このMCPサーバーは以下の機能を提供します:
ワークスペース管理: 組織内のワークスペース一覧取得、ユーザー一覧、アクセスURL生成
グループ管理: 組織内のグループ一覧取得、メンバー管理
通知機能: 組織、ワークスペース、グループへの通知送信
情報取得: スペース名の取得など
初期設定
Claude Desktop
設定ファイルを編集してMCPサーバーを登録します。
MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"ovice-mcp-server": {
"command": "npx",
"args": ["github:cti1650/ovice-mcp-server"],
"env": {
"OVICE_DOMAIN": "api.ovice.com",
"OVICE_CLIENT_ID": "your-client-id",
"OVICE_CLIENT_SECRET": "your-client-secret",
"OVICE_ORGANIZATION_ID": "your-organization-id",
"OVICE_SERVICE_NAME": "Your Service Name",
"OVICE_SERVICE_LOGO_URL": "https://your-logo-url.com/logo.svg"
}
}
}
}環境変数
変数名 | 必須 | デフォルト値 | 説明 |
| ✓ | - | oVice APIクライアントID |
| ✓ | - | oVice APIクライアントシークレット |
| ✓ | - | 組織ID |
| - | "api.ovice.com" | oVice APIドメイン(本番環境以外では変更が必要) |
| - | "This is demo" | 通知に表示されるサービス名 |
| - | oViceロゴURL | 通知に表示されるサービスロゴURL |
利用可能なツール
ワークスペース関連
get_organization_workspaces
説明: 組織のワークスペース一覧を取得
パラメータ: なし
戻り値: ワークスペース一覧(JSON形式)
get_workspace_users
説明: 指定したワークスペースのユーザー一覧を取得
パラメータ:
workspaceId(string): ワークスペースID
戻り値: ユーザー一覧(JSON形式)
get_space_name_by_id
説明: スペースIDからスペース名を取得
パラメータ:
spaceId(string): スペースID
戻り値: スペース名
get_workspace_access_path
説明: ワークスペースにアクセスするためのURLを生成
パラメータ:
workspaceId(string): ワークスペースID
戻り値: アクセスURL (
https://{appDomain}/ws/{workspaceDomain}/)備考: APIからワークスペース情報を取得し、ドメインベースのURLを生成
グループ関連
get_organization_groups
説明: 組織のグループ一覧を取得
パラメータ: なし
戻り値: グループ一覧(JSON形式)
get_group_members
説明: 指定したグループのメンバー一覧を取得
パラメータ:
groupId(string): グループID
戻り値: メンバー一覧(JSON形式)
通知機能
send_organization_notification
説明: 組織全体に通知を送信
パラメータ:
message(string): 通知メッセージserviceName(string, optional): サービス名serviceLogoUrl(string, optional): サービスロゴURL
戻り値: 送信結果(JSON形式)
send_workspace_notification
説明: 特定のワークスペースに通知を送信
パラメータ:
workspaceId(string): ワークスペースIDauth(array): 通知対象の権限レベル ("admin", "member", "visitor", "guest")message(string): 通知メッセージserviceName(string, optional): サービス名serviceLogoUrl(string, optional): サービスロゴURL
戻り値: 送信結果(JSON形式)
send_group_notification
説明: 特定のグループに通知を送信
パラメータ:
groupId(string): グループIDmessage(string): 通知メッセージserviceName(string, optional): サービス名serviceLogoUrl(string, optional): サービスロゴURL
戻り値: 送信結果(JSON形式)
API仕様
このMCPサーバーは oVice Public API v1 を使用します:
エンドポイント:
https://{OVICE_DOMAIN}/api/public/v1/認証: クライアントIDとクライアントシークレットによるヘッダー認証
エラーハンドリング
環境変数が不足している場合は適切なエラーメッセージを表示
API呼び出し失敗時はHTTPステータスコードとエラー詳細を返却
指定されたリソース(ワークスペース、グループなど)が見つからない場合は専用のエラーメッセージを表示
参考サイト
Available Tools
9 toolsget_group_membersB
グループのメンバー一覧を取得する
Inputs: groupId (required).
get_organization_groupsB
組織のグループ一覧を取得する
Inputs: no named parameters.
get_organization_workspacesB
組織のワークスペース一覧を取得する
Inputs: no named parameters.
get_space_name_by_idB
スペースIDからスペース名を取得する
Inputs: spaceId (required).
get_workspace_access_pathC
ワークスペースにアクセスするためのパスを返す
Inputs: workspaceId (required).
get_workspace_usersB
ワークスペースのユーザー一覧を取得する
Inputs: workspaceId (required).
send_group_notificationB
グループに通知を送信する
Inputs: groupId (required), message (required), serviceName, serviceLogoUrl.
send_organization_notificationC
組織に通知を送信する
Inputs: message (required), serviceName, serviceLogoUrl.
send_workspace_notificationC
ワークスペースに通知を送信する
Inputs: auth (required), message (required), workspaceId (required), serviceName, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct resource and action: get operations for workspaces, users, spaces, access paths, groups, and members, plus send operations for notifications to different scopes. No two tools overlap in purpose.
All tools follow a consistent 'get_' or 'send_' prefix followed by a specific object, making the action and target predictable. The pattern is uniform across the set.
Nine tools is well within the ideal 3-15 range, and each tool addresses a specific need in the ovice management domain.
The toolset covers the main information retrieval and notification needs for organizations, workspaces, and groups. While there are no create/update/delete operations, they appear out of scope for this server's apparent purpose.
Maintenance
Related MCP Connectors
Your SMB workspace in Claude or ChatGPT: tasks, notes, sales and Michèle's memory, via OAuth.
Work with shared spaces, threads, documents, skills, apps, automations, and connected tools.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides seamless integration with Capacities knowledge management system, allowing Claude to list spaces, retrieve space information, search content, save weblinks, and add content to daily notes.542MIT
- AlicenseCqualityDmaintenanceEnables Claude to interact with ServiceNow instances through comprehensive API integration. Supports incident management, service catalog operations, change requests, knowledge base management, user administration, and agile project management with multiple authentication methods.82MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to interact with DingTalk workspaces to search for users, retrieve detailed employee information, and send private messages. It bridges the Model Context Protocol with DingTalk's internal enterprise APIs for seamless workspace communication.9 npm5MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to manage Okta organizations, including users, groups, and applications, via natural language.7MIT