5分でWeCom(企業WeChat)に接続するAI Agentを構築:MCPプロトコル実践チュートリアル
なぜWeCom + MCP?
WeCom(企業WeChat)は中国企業の80%以上をカバー。AI AgentをWeComに接続する利点:
- 学習コストゼロ:使い慣れたチャットインターフェースでAIを利用
- 内蔵権限体系:WeComの組織架构と権限を再利用
- メッセージ到達:AIが従業員やグループにプロアクティブにメッセージ送信
- 承認統合:AIが従業員に代わって承認フローを開始
WeCom + MCP = エンタープライズAI Agentへの最短パス
アーキテクチャ
┌──────────────┐ MCP Protocol ┌──────────────────┐ HTTP API ┌──────────────┐
│ AI Agent │ ◄──────────────────► │ MCP Server │ ◄──────────────► │ WeCom API │
│ (Claude) │ JSON-RPC │ (Our impl) │ REST calls │ │
└──────────────┘ └──────────────────┘ └──────────────┘
ステップ1:WeComアプリケーションの作成
WeCom管理コンソールにログイン:
1. アプリ管理 → アプリ作成
2. 認証情報を記録:
- corpId: ww1234567890abcdef
- agentId: 1000002
- secret: xxxxxxxxxxxxxxxxxxxxxxxxxx
3. コールバックURL: https://your-domain.com/wecom/callback
ステップ2:MCP Serverの実装
コア依存関係
<dependencies>
<dependency>
<groupId>io.modelcontextprotocol</groupId>
<artifactId>mcp-spring-boot-starter</artifactId>
<version>0.7.0</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>3.3.0</version>
</dependency>
</dependencies>
メッセージ送信Tool
@Component
public class SendMessageTool implements McpTool {
@Override
public String name() {
return "send_message";
}
@Override
public String description() {
return "WeComを通じてメッセージを送信";
}
@Override
public McpToolResult execute(Map<String, Object> args) {
String receiverType = (String) args.get("receiverType");
String receiverId = (String) args.get("receiverId");
String messageType = (String) args.get("messageType");
String content = (String) args.get("content");
try {
String msgId = wecomClient.sendMessage(
receiverType, receiverId, messageType, content
);
return McpToolResult.success(Map.of("msgId", msgId, "status", "sent"));
} catch (WecomApiException e) {
return McpToolResult.error("送信失敗: " + e.getMessage());
}
}
}
ステップ3:Claude Desktopでの設定
{
"mcpServers": {
"wecom": {
"url": "http://localhost:8081/mcp/sse",
"transport": "sse"
}
}
}
本番デプロイ
FROM eclipse-temurin:21-jre-alpine
WORKDIR /app
COPY target/wecom-mcp-server.jar app.jar
EXPOSE 8081
ENTRYPOINT ["java", "-jar", "app.jar"]
まとめ
MCPプロトコルの標準化により、MCP Serverを一度実装すれば、すべてのMCP対応AIツールで利用可能:
- 一度実装、どこでも利用:Claude、Cursor、カスタムAgentすべて接続可能
- Spring Bootエコシステム:WeCom SDK、認証、監査がすぐに利用可能
- 本番対応:自動トークンリフレッシュ、レート制限、監査ログ、Dockerデプロイ
これは「AIがチャットする」から「AIが働く」への最短パスです。
ブラウザローカルツールを無料で試す →
#MCP#企业微信#AI Agent#WeCom#工具调用#企业级