使用说明
IBM ODM编写MCP服务器文档
概述
IBM ODM创作MCP服务器将IBM ODM决策中心与现代AI助手和编排平台连接起来。 它使您能够:
- 公开决策中心REST API端点作为人工智能助手的工具
- 轻松与Watson Orchestrate、Claude Desktop和Cursor AI集成
特性
- 工具集成: 将ODM决策中心REST API端点作为工具公开
- 身份验证: Zen API密钥、基本验证和OpenID连接
- 多平台: 与Watson Orchestrate、Claude Desktop和Cursor AI配合使用
快速入门:Claude桌面集成
有关设置和使用Claude Desktop与决策MCP服务器的详细说明,请参阅 Claude桌面集成指南.
演示视频
先决条件和安装
先决条件
运行服务器
配置
配置参数表
| CLI参数 | 环境变量 | 描述 | 默认值 |
|---|---|---|---|
--url |
ODM_URL |
决策中心REST API的URL | http://localhost:9060/decisioncenter-api |
--username |
ODM_USERNAME |
基本身份验证或Zen身份验证的用户名 | odmAdmin |
--password |
ODM_PASSWORD |
基本身份验证密码 | odmAdmin |
--zenapikey |
ZENAPIKEY |
用于使用Cloud Pak进行身份验证的Zen API密钥,用于业务自动化 | |
--client-id |
CLIENT_ID |
用于身份验证的OpenID Connect客户端ID | |
--client-secret |
CLIENT_SECRET |
OpenID连接用于身份验证的客户端密钥 | |
--pkjwt-cert-path |
PKJWT_CERT_PATH |
PKJWT身份验证证书的路径(PKJWT强制要求) | |
--pkjwt-key-path |
PKJWT_KEY_PATH |
PKJWT身份验证的私钥证书路径(PKJWT必须提供) | |
--pkjwt-key-password |
PKJWT_KEY_PASSWORD |
用于解密PKJWT身份验证私钥的密码。仅当密钥受密码保护时才需要。 | |
--token-url |
TOKEN_URL |
用于身份验证的OpenID Connect令牌端点URL | |
--scope |
SCOPE |
使用客户端凭据进行身份验证请求访问令牌时使用的OpenID Connect作用域 | openid |
--verifyssl |
VERIFY_SSL |
是否验证SSL证书(True 或 False) |
True |
--ssl-cert-path |
SSL_CERT_PATH |
SSL证书文件的路径。如果未提供,则默认为系统证书。 | |
--mtls-cert-path |
MTLS_CERT_PATH |
用于双向TLS身份验证的客户端SSL证书文件的路径(mTLS强制要求) | |
--mtls-key-path |
MTLS_KEY_PATH |
用于双向TLS身份验证的客户端SSL私钥文件的路径(mTLS强制要求) | |
--mtls-key-password |
MTLS_KEY_PASSWORD |
用于解密客户端私钥以进行双向TLS身份验证的密码。仅当密钥受密码保护时才需要。 | |
--log-level |
LOG_LEVEL |
设置日志记录级别(DEBUG, INFO, WARNING, ERROR, CRITICAL) |
INFO |
特定于决策中心REST API的参数
CLI参数 环境变量 描述 默认值 --tagsTAGS标签列表(例如,关于探索构建)。仅保留标签在列表中的工具是有用的。如果未指定此选项,则所有工具都由MCP服务器发布。 --toolsTOOLS要发布的工具列表(例如decisionServices版本createRelease)。此选项可以与--tags一起使用,但优先于--no tools选项 --no-toolsNO_TOOLS要忽略的工具列表(例如launchCleanup擦除executeSqlScript)。此选项可以与--tags一起使用,但如果指定了--tools选项,则会忽略此选项。
在远程模式下启动MCP服务器的参数(允许来自远程MCP客户端的连接)
CLI参数 环境变量 描述 默认值 --transportTRANSPORTstdio,streamable-http或sse:决策MCP服务器的通信方式:本地(stdio)或远程(streamable-http或sse))stdio--hostHOSTMCP服务器在远程模式下监听的IP或主机名。 0.0.0.0--portPORTMCP服务器在远程模式下监听的端口。 3000--mount-pathMOUNT_PATHMCP服务器在远程模式下监听的路径。 /mcp