Skip to main content
Glama

AgileWorks MCP Server

AgileWorksの公式ローカルMCPサーバーです。

目次

Related MCP server: ConnectWise API Gateway MCP Server

前提条件

  • Node.js v24.13.0 以上

  • AgileWorksのライセンスにWebAPIオプションが含まれていること

互換性

本MCPサーバーのバージョンと、対応するAgileWorks Web APIのバージョンは以下の通りです。

AgileWorks MCP Server タグ

対応AgileWorksバージョン

備考

v0.1.0

R3.2.0

初版

v0.1.1

R3.2.0~R3.3.0

第2版

インストール

ローカルMCPサーバー

  1. 依存モジュールをインストールします。

    cd aw-app
    npm install
  2. MCPクライアント(例: Claude Desktop など)の設定ファイルに、以下の内容を追記してください。

    Claude Desktop の場合は claude_desktop_config.json に追記します。

    {
        "mcpServers": {
            "AgileWorks": {
                "command": "{nodejsのインストールディレクトリの絶対パス}",
                "args": [
                    "{aw-app/dist/custom/admin/server.js の絶対パス}"
                ],
                "env": {
                     "SYSTEM_URL": "{AgileWorksのシステムURL}",
                    "ACCESS_TOKEN": "{AgileWorks WebAPIで使用するOAuth2のアクセストークン}"
                }
            }
        }
    }

    設定例:

    {
        "mcpServers": {
            "AgileWorks": {
                "command": "c:\\nvm4w\\nodejs\\node",
                "args": [
                    "C:\\temp\\agileworks-mcp-server\\aw-app\\dist\\custom\\admin\\server.js"
                ],
                "env": {
                    "SYSTEM_URL": "https://sample.co.jp/AgileWorks",
                    "ACCESS_TOKEN": "abcdefghijklmnopqrstuvwxyz"
                }
            }
        }
    }

リモートMCPサーバー

Dockerを使用することで、リモートMCPサーバーとして公開できます。

前提条件

  • MCPサーバー用のポート番号を許可してください (デフォルトは8002)

NOTE

.env.example をリネームして .env を作成し、MCP_PORT でポート番号を変更できます。

ファイル構成

aw-app/
├── dist/
├── Dockerfile
├── docker-compose.yml
└── .env (※任意)

設定手順

  1. Docker コンテナをビルド・起動します。

    cd aw-app
    docker compose build
    docker compose up -d
  2. MCP クライアント(例: Claude Desktop など)の設定ファイルに、以下の内容を追記します。

    {
      "mcpServers": {
        "AgileWorks": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "http(s)://{FQDN}/mcp",
            "--header",
            "x-system-url: {AgileWorksのシステムURL}",
            "--header",
            "x-access-token: {AgileWorks WebAPIで使用するOAuth2のアクセストークン}"
          ]
        }
      }
    }

    設定例:

    {
      "mcpServers": {
        "AgileWorks": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://sample.co.jp/mcp",
            "--header",
            "x-system-url: https://example.com/AgileWorks",
            "--header",
            "x-access-token: abcdefghijklmnopqrstuvwxyz"
          ]
        }
      }
    }
NOTE

ChatGPTなどのAIエージェントでは、x-system-url / x-access-token をクエリパラメータでも指定できます(リクエストは /mcp への POST)。 ただし URL にトークンを含めるとアクセスログ等に残る可能性があるため、可能な限りヘッダー指定を推奨します。

http(s)://{FQDN}/mcp?x-system-url={AgileWorksのシステムURL}&x-access-token={AgileWorks WebAPIで使用するOAuth2のアクセストークン}

例:

https://sample.co.jp/mcp?x-system-url=https://example.com/AgileWorks&x-access-token=abcdefghijklmnopqrstuvwxyz
TIP

nginx / Traefikなどを用いてリバースプロキシを配置することで、リモートMCPサーバーのエンドポイントを変更することができます。

リモートMCPサーバーのアップデート

  1. リモートMCPサーバーを停止します。

cd aw-app
docker compose down
  1. (任意)docker-compose.ymlとDockerfileのバックアップを行います。

cp docker-compose.yml docker-compose.yml.$(date +%s).bak
cp Dockerfile Dockerfile.$(date +%s).bak
  1. 最新のソースコードを取得します。

  2. Dockerコンテナを再ビルド・起動します。

docker compose build
docker compose up -d

Tools

MCPサーバーで使用できるツールは以下の通りです。

CAUTION
  • 破壊的な操作(例: ユーザー削除、書類却下)を行うToolは慎重に使用してください

  • MCPクライアントに登録するTool数が多すぎると、AIが適切なToolを選択できなくなる場合があります。必要なToolのみを有効にすることを推奨します

  • 本ツールは現在α版として公開されており、仕様が予告なく変更される場合があります。

  • 基礎的な動作確認は AgileWorks R3.2.0 で実施していますが、予期しない動作が発生する可能性があります。

書類操作

Tool名

説明

getDocHeader

書類情報取得API

getDoc

書類データ取得API

prepareDocRequest

新規書類データ作成API

addDoc

新規書類データ保存API

updateDoc

書類データ更新API

hardDeleteDoc

書類物理削除API

selectDoc

書類検索API

getDocPdf

書類PDFファイル取得API

openDoc

書類表示API

書類コメント

Tool名

説明

listDocComment

書類コメント一覧取得API

addDocComment

書類メモ追加API

deleteDocComment

書類コメント/メモ削除API

書類添付情報

Tool名

説明

addDocAttachment

書類添付情報追加API (URLのみ添付可)

updateDocAttachment

書類添付情報更新API (URLのみ添付可)

listDocAttachment

書類添付情報一覧取得API

deleteDocAttachment

書類添付情報削除API

関連書類

Tool名

説明

getDocReference

参照元関連書類情報取得API

listDocReferencer

参照先関連書類情報一覧API

addDocReference

関連書類追加API

deleteDocReference

関連書類削除API

ワークフロー

Tool名

説明

countWorkflowMessage

回付情報件数取得API

countListWorkflowMessage

回付情報件数一覧取得API

selectWorkflowMessage

回付情報検索API

docDraft

書類下書き保存API

docStart

書類作成/申請API

docApprove

書類承認API

docDelete

書類論理削除API

docRemand

書類差戻しAPI

docRetract

書類引戻しAPI

docReject

書類却下API

getWorkflowInfo

回付情報件数取得API

findWorkflowTask

回付情報タスク検索API

listWorkflowJournal

回付履歴一覧取得API

listElectJournal

処理者変更履歴一覧取得API

listShareJournal

共有履歴一覧取得API

ユーザー管理

Tool名

説明

addUser

ユーザー作成API

findUser

ユーザー参照API

updateUser

ユーザー更新API

deleteUser

ユーザー削除API

disableUser

ユーザー適用終了API

組織管理

Tool名

説明

addUnit

組織作成API

findUnit

組織参照API

updateUnit

組織更新API

deleteUnit

組織削除API

disableUnit

組織適用終了API

セクションロール

Tool名

説明

addSectionRole

セクションロール作成API

findSectionRole

セクションロール参照API

updateSectionRole

セクションロール更新API

deleteSectionRole

セクションロール削除API

セクションロールグループ

Tool名

説明

addSectionRoleGroup

セクションロールグループ作成API

findSectionRoleGroup

セクションロールグループ参照API

updateSectionRoleGroup

セクションロールグループ更新API

deleteSectionRoleGroup

セクションロールグループ削除API

組織所属

Tool名

説明

addUnitAppointment

組織所属作成API

findUnitAppointment

組織所属参照API

updateUnitAppointment

組織所属更新API

deleteUnitAppointment

組織所属削除API

disableUnitAppointment

組織所属適用終了API

代理申請

Tool名

説明

addProxyApplyAppointment

代理申請作成API

findProxyApplyAppointment

代理申請参照API

updateProxyApplyAppointment

代理申請更新API

deleteProxyApplyAppointment

代理申請削除API

disableProxyApplyAppointment

代理申請適用終了API

代理承認

Tool名

説明

addProxyAppointment

代理承認作成API

findProxyAppointment

代理承認参照API

updateProxyAppointment

代理承認更新API

deleteProxyAppointment

代理承認削除API

disableProxyAppointment

代理承認適用終了API

権限委譲

Tool名

説明

addDelegationAppointment

権限委譲作成API

findDelegationAppointment

権限委譲参照API

updateDelegationAppointment

権限委譲更新API

deleteDelegationAppointment

権限委譲削除API

disableDelegationAppointment

権限委譲適用終了API

引上げ権限

Tool名

説明

addDeprivationAppointment

引上げ権限作成API

findDeprivationAppointment

引上げ権限参照API

updateDeprivationAppointment

引上げ権限更新API

deleteDeprivationAppointment

引上げ権限削除API

disableDeprivationAppointment

引上げ権限適用終了API

プライベートロール

Tool名

説明

addPrivateRole

プライベートロール作成API

findPrivateRole

プライベートロール参照API

updatePrivateRole

プライベートロール更新API

deletePrivateRole

プライベートロール削除API

プライベートロール所属

Tool名

説明

addPrivateRoleAppointment

プライベートロール所属作成API

findPrivateRoleAppointment

プライベートロール所属参照API

updatePrivateRoleAppointment

プライベートロール所属更新API

deletePrivateRoleAppointment

プライベートロール所属削除API

disablePrivateRoleAppointment

プライベートロール所属適用終了API

ユニバーサルロール

Tool名

説明

addUniversalRole

ユニバーサルロール作成API

findUniversalRole

ユニバーサルロール参照API

updateUniversalRole

ユニバーサルロール更新API

deleteUniversalRole

ユニバーサルロール削除API

ユニバーサルロール所属

Tool名

説明

addUniversalRoleAppointment

ユニバーサルロール所属作成API

findUniversalRoleAppointment

ユニバーサルロール所属参照API

updateUniversalRoleAppointment

ユニバーサルロール所属更新API

deleteUniversalRoleAppointment

ユニバーサルロール所属削除API

disableUniversalRoleAppointment

ユニバーサルロール所属適用終了API

業務カテゴリ

Tool名

説明

findProject

業務カテゴリ一覧取得API

外部マスタ

Tool名

説明

importTinyUserMaster

外部マスタ(標準)取込API

exportTinyUserMaster

外部マスタ(標準)取得API

importUserMaster

外部マスタ(拡張)取込API

exportUserMaster

外部マスタ(拡張)取得API

コンポーネント

Tool名

説明

listComponentMasterWindow

マスター参照コンポーネント一覧取得API

listComponentAutoNumber

自動採番コンポーネント一覧取得API

フォーム

Tool名

説明

listForm

登録フォーム一覧取得API

findFormDefinition

フォーム定義情報取得API

listPublicFolderInfo

公開フォルダ・公開フォーム取得API

管理者権限不要

Tool名

説明

notAdminGetVersion

バージョン情報取得API

ライセンス

MIT

免責事項・サポートについて

本リポジトリは、動作保証や技術サポートは行いません。 本サーバーの使用によって生じた、いかなる直接的・間接的な損害(データの消失、業務の中断、セキュリティ上の問題など)についても、一切の責任を負いません。設定や運用は、利用者自身の責任において十分な検証の上で行ってください。

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
5moRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/atled-workflow/agileworks-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server