English Français العربية

io.github.ONLYOFFICE/docspace

السجل الرسمي أخرى

A room-based collaborative platform

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع io.github.ONLYOFFICE/docspace؟

  • Tools with granular control - Access to tools organized into logical
  • Multiple transport protocols - Support for stdio, SSE, and Streamable HTTP
  • Different authentication methods - Supports API keys, Personal Access
  • Request-level configuration - Configure authentication and tool selection
  • Various distribution formats - Available as Docker image, [Docker MCP

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (sse)
Claude Code 
claude mcp add --transport sse docspace 'https://mcp.onlyoffice.com/sse' --header 'X-Mcp-Api-Key: <The API key for accessing the API.>' --header 'X-Mcp-Auth-Token: <The Personal Access Token (PAT) for accessing the API.>' --header 'X-Mcp-Base-Url: <The base URL of the ONLYOFFICE Apps instance for API requests.>' --header 'X-Mcp-Disabled-Tools: <The list of tools to disable for the MCP server.>' --header 'X-Mcp-Dynamic: <The flag that indicates whether the MCP server should use meta tools.>' --header 'X-Mcp-Enabled-Tools: <The list of tools to enable for the MCP server.>' --header 'X-Mcp-Password: <The password for accessing the API using basic authentication.>' --header 'X-Mcp-Toolsets: <The list of toolsets to enable for the MCP server.>' --header 'X-Mcp-Username: <The username for accessing the API using basic authentication.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "docspace": {
            "type": "sse",
            "url": "https://mcp.onlyoffice.com/sse",
            "headers": {
                "X-Mcp-Api-Key": "<The API key for accessing the API.>",
                "X-Mcp-Auth-Token": "<The Personal Access Token (PAT) for accessing the API.>",
                "X-Mcp-Base-Url": "<The base URL of the ONLYOFFICE Apps instance for API requests.>",
                "X-Mcp-Disabled-Tools": "<The list of tools to disable for the MCP server.>",
                "X-Mcp-Dynamic": "<The flag that indicates whether the MCP server should use meta tools.>",
                "X-Mcp-Enabled-Tools": "<The list of tools to enable for the MCP server.>",
                "X-Mcp-Password": "<The password for accessing the API using basic authentication.>",
                "X-Mcp-Toolsets": "<The list of toolsets to enable for the MCP server.>",
                "X-Mcp-Username": "<The username for accessing the API using basic authentication.>"
            }
        }
    }
}
Remote (streamable-http)
Claude Code 
claude mcp add --transport http docspace 'https://mcp.onlyoffice.com/mcp' --header 'X-Mcp-Api-Key: <The API key for accessing the API.>' --header 'X-Mcp-Auth-Token: <The Personal Access Token (PAT) for accessing the API.>' --header 'X-Mcp-Base-Url: <The base URL of the ONLYOFFICE Apps instance for API requests.>' --header 'X-Mcp-Disabled-Tools: <The list of tools to disable for the MCP server.>' --header 'X-Mcp-Dynamic: <The flag that indicates whether the MCP server should use meta tools.>' --header 'X-Mcp-Enabled-Tools: <The list of tools to enable for the MCP server.>' --header 'X-Mcp-Password: <The password for accessing the API using basic authentication.>' --header 'X-Mcp-Toolsets: <The list of toolsets to enable for the MCP server.>' --header 'X-Mcp-Username: <The username for accessing the API using basic authentication.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "docspace": {
            "type": "http",
            "url": "https://mcp.onlyoffice.com/mcp",
            "headers": {
                "X-Mcp-Api-Key": "<The API key for accessing the API.>",
                "X-Mcp-Auth-Token": "<The Personal Access Token (PAT) for accessing the API.>",
                "X-Mcp-Base-Url": "<The base URL of the ONLYOFFICE Apps instance for API requests.>",
                "X-Mcp-Disabled-Tools": "<The list of tools to disable for the MCP server.>",
                "X-Mcp-Dynamic": "<The flag that indicates whether the MCP server should use meta tools.>",
                "X-Mcp-Enabled-Tools": "<The list of tools to enable for the MCP server.>",
                "X-Mcp-Password": "<The password for accessing the API using basic authentication.>",
                "X-Mcp-Toolsets": "<The list of toolsets to enable for the MCP server.>",
                "X-Mcp-Username": "<The username for accessing the API using basic authentication.>"
            }
        }
    }
}
MCPB package https://github.com/ONLYOFFICE/docspace-mcp/releases/download/v3.3.0/onlyoffice-docspace-mcp-3.3.0.mcpb

متغيرات البيئة

  • DOCSPACE_API_KEY سري The API key for accessing the API.
  • DOCSPACE_BASE_URL The base URL of the ONLYOFFICE Apps instance for API requests.
  • DOCSPACE_FILE_OPERATION_INTERVAL The interval for polling the status of in-progress file operations in milliseconds.
  • DOCSPACE_FILE_OPERATION_TIMEOUT The maximum time to wait for a file operation to complete in milliseconds.
NPM package @onlyoffice/docspace-mcp
Claude Code 
claude mcp add docspace -e 'DOCSPACE_API_KEY=<your docspace_api_key>' -e 'DOCSPACE_AUTH_TOKEN=<your docspace_auth_token>' -e 'DOCSPACE_AUTHORIZATION=<your docspace_authorization>' -e 'DOCSPACE_BASE_URL=<DOCSPACE_BASE_URL>' -e 'DOCSPACE_DISABLED_TOOLS=<DOCSPACE_DISABLED_TOOLS>' -e 'DOCSPACE_DYNAMIC=false' -e 'DOCSPACE_ENABLED_TOOLS=<DOCSPACE_ENABLED_TOOLS>' -e 'DOCSPACE_FILE_OPERATION_INTERVAL=300' -e 'DOCSPACE_FILE_OPERATION_TIMEOUT=3600000' -e 'DOCSPACE_PASSWORD=<your docspace_password>' -e 'DOCSPACE_TOOLSETS=all' -e 'DOCSPACE_TRANSPORT=stdio' -e 'DOCSPACE_USER_AGENT=@onlyoffice/docspace-mcp v3.3.0' -e 'DOCSPACE_USERNAME=<DOCSPACE_USERNAME>' -- npx -y @onlyoffice/docspace-mcp@3.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "docspace": {
            "command": "npx",
            "args": [
                "-y",
                "@onlyoffice/docspace-mcp@3.3.0"
            ],
            "env": {
                "DOCSPACE_API_KEY": "<your docspace_api_key>",
                "DOCSPACE_AUTH_TOKEN": "<your docspace_auth_token>",
                "DOCSPACE_AUTHORIZATION": "<your docspace_authorization>",
                "DOCSPACE_BASE_URL": "<DOCSPACE_BASE_URL>",
                "DOCSPACE_DISABLED_TOOLS": "<DOCSPACE_DISABLED_TOOLS>",
                "DOCSPACE_DYNAMIC": "false",
                "DOCSPACE_ENABLED_TOOLS": "<DOCSPACE_ENABLED_TOOLS>",
                "DOCSPACE_FILE_OPERATION_INTERVAL": "300",
                "DOCSPACE_FILE_OPERATION_TIMEOUT": "3600000",
                "DOCSPACE_PASSWORD": "<your docspace_password>",
                "DOCSPACE_TOOLSETS": "all",
                "DOCSPACE_TRANSPORT": "stdio",
                "DOCSPACE_USER_AGENT": "@onlyoffice/docspace-mcp v3.3.0",
                "DOCSPACE_USERNAME": "<DOCSPACE_USERNAME>"
            }
        }
    }
}

متغيرات البيئة

  • DOCSPACE_API_KEY سري The API key for accessing the API.
  • DOCSPACE_AUTH_TOKEN سري The Personal Access Token (PAT) for accessing the API.
  • DOCSPACE_AUTHORIZATION سري The raw value to include in the Authorization header for API requests.
  • DOCSPACE_BASE_URL The base URL of the ONLYOFFICE Apps instance for API requests.
  • DOCSPACE_DISABLED_TOOLS The list of tools to disable for the MCP server.
  • DOCSPACE_DYNAMIC The flag that indicates whether the MCP server should use meta tools.
  • DOCSPACE_ENABLED_TOOLS The list of tools to enable for the MCP server.
  • DOCSPACE_FILE_OPERATION_INTERVAL The interval for polling the status of in-progress file operations in milliseconds.
  • DOCSPACE_FILE_OPERATION_TIMEOUT The maximum time to wait for a file operation to complete in milliseconds.
  • DOCSPACE_PASSWORD سري The password for accessing the API using basic authentication.
  • DOCSPACE_TOOLSETS The list of toolsets to enable for the MCP server.
  • DOCSPACE_TRANSPORT The transport protocol to use for communication with the MCP server.
  • DOCSPACE_USER_AGENT The user agent to include in the User-Agent header for API requests.
  • DOCSPACE_USERNAME The username for accessing the API using basic authentication.
NPM package @onlyoffice/docspace-mcp
Claude Code 
claude mcp add docspace -e 'DOCSPACE_API_KEY=<your docspace_api_key>' -e 'DOCSPACE_AUTH_TOKEN=<your docspace_auth_token>' -e 'DOCSPACE_AUTHORIZATION=<your docspace_authorization>' -e 'DOCSPACE_BASE_URL=<DOCSPACE_BASE_URL>' -e 'DOCSPACE_DISABLED_TOOLS=<DOCSPACE_DISABLED_TOOLS>' -e 'DOCSPACE_DYNAMIC=false' -e 'DOCSPACE_ENABLED_TOOLS=<DOCSPACE_ENABLED_TOOLS>' -e 'DOCSPACE_FILE_OPERATION_INTERVAL=300' -e 'DOCSPACE_FILE_OPERATION_TIMEOUT=3600000' -e 'DOCSPACE_HOST=127.0.0.1' -e 'DOCSPACE_OAUTH_AUTH_TOKEN_ALGORITHM=HS256' -e 'DOCSPACE_OAUTH_AUTH_TOKEN_SECRET_KEY=<your docspace_oauth_auth_token_secret_key>' -e 'DOCSPACE_OAUTH_AUTH_TOKEN_TTL=3600000' -e 'DOCSPACE_OAUTH_BASE_URL=<DOCSPACE_OAUTH_BASE_URL>' -e 'DOCSPACE_OAUTH_CLIENT_ID=<DOCSPACE_OAUTH_CLIENT_ID>' -e 'DOCSPACE_OAUTH_CLIENT_SECRET=<your docspace_oauth_client_secret>' -e 'DOCSPACE_OAUTH_STATE_TOKEN_ALGORITHM=HS256' -e 'DOCSPACE_OAUTH_STATE_TOKEN_SECRET_KEY=<your docspace_oauth_state_token_secret_key>' -e 'DOCSPACE_OAUTH_STATE_TOKEN_TTL=3600000' -e 'DOCSPACE_PASSWORD=<your docspace_password>' -e 'DOCSPACE_PORT=8080' -e 'DOCSPACE_PROXY_HOPS=0' -e 'DOCSPACE_REQUEST_AUTHORIZATION_HEADER=true' -e 'DOCSPACE_REQUEST_HEADER_PREFIX=X-Mcp-' -e 'DOCSPACE_REQUEST_QUERY=true' -e 'DOCSPACE_SERVER_ALLOWED_HOSTNAMES=localhost,127.0.0.1,[::1]' -e 'DOCSPACE_SERVER_BASE_URL=<DOCSPACE_SERVER_BASE_URL>' -e 'DOCSPACE_SERVER_CORS_MCP_MAX_AGE=86400000' -e 'DOCSPACE_SERVER_CORS_MCP_ORIGIN=*' -e 'DOCSPACE_SERVER_CORS_OAUTH_MAX_AGE=86400000' -e 'DOCSPACE_SERVER_CORS_OAUTH_ORIGIN=*' -e 'DOCSPACE_SERVER_RATE_LIMITS_MCP_CAPACITY=1000' -e 'DOCSPACE_SERVER_RATE_LIMITS_MCP_WINDOW=1000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_WINDOW=60000' -e 'DOCSPACE_SESSION_INTERVAL=240000' -e 'DOCSPACE_SESSION_TTL=28800000' -e 'DOCSPACE_TOOLSETS=all' -e 'DOCSPACE_TRANSPORT=stdio' -e 'DOCSPACE_USER_AGENT=@onlyoffice/docspace-mcp v3.3.0' -e 'DOCSPACE_USERNAME=<DOCSPACE_USERNAME>' -- npx -y @onlyoffice/docspace-mcp@3.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "docspace": {
            "command": "npx",
            "args": [
                "-y",
                "@onlyoffice/docspace-mcp@3.3.0"
            ],
            "env": {
                "DOCSPACE_API_KEY": "<your docspace_api_key>",
                "DOCSPACE_AUTH_TOKEN": "<your docspace_auth_token>",
                "DOCSPACE_AUTHORIZATION": "<your docspace_authorization>",
                "DOCSPACE_BASE_URL": "<DOCSPACE_BASE_URL>",
                "DOCSPACE_DISABLED_TOOLS": "<DOCSPACE_DISABLED_TOOLS>",
                "DOCSPACE_DYNAMIC": "false",
                "DOCSPACE_ENABLED_TOOLS": "<DOCSPACE_ENABLED_TOOLS>",
                "DOCSPACE_FILE_OPERATION_INTERVAL": "300",
                "DOCSPACE_FILE_OPERATION_TIMEOUT": "3600000",
                "DOCSPACE_HOST": "127.0.0.1",
                "DOCSPACE_OAUTH_AUTH_TOKEN_ALGORITHM": "HS256",
                "DOCSPACE_OAUTH_AUTH_TOKEN_SECRET_KEY": "<your docspace_oauth_auth_token_secret_key>",
                "DOCSPACE_OAUTH_AUTH_TOKEN_TTL": "3600000",
                "DOCSPACE_OAUTH_BASE_URL": "<DOCSPACE_OAUTH_BASE_URL>",
                "DOCSPACE_OAUTH_CLIENT_ID": "<DOCSPACE_OAUTH_CLIENT_ID>",
                "DOCSPACE_OAUTH_CLIENT_SECRET": "<your docspace_oauth_client_secret>",
                "DOCSPACE_OAUTH_STATE_TOKEN_ALGORITHM": "HS256",
                "DOCSPACE_OAUTH_STATE_TOKEN_SECRET_KEY": "<your docspace_oauth_state_token_secret_key>",
                "DOCSPACE_OAUTH_STATE_TOKEN_TTL": "3600000",
                "DOCSPACE_PASSWORD": "<your docspace_password>",
                "DOCSPACE_PORT": "8080",
                "DOCSPACE_PROXY_HOPS": "0",
                "DOCSPACE_REQUEST_AUTHORIZATION_HEADER": "true",
                "DOCSPACE_REQUEST_HEADER_PREFIX": "X-Mcp-",
                "DOCSPACE_REQUEST_QUERY": "true",
                "DOCSPACE_SERVER_ALLOWED_HOSTNAMES": "localhost,127.0.0.1,[::1]",
                "DOCSPACE_SERVER_BASE_URL": "<DOCSPACE_SERVER_BASE_URL>",
                "DOCSPACE_SERVER_CORS_MCP_MAX_AGE": "86400000",
                "DOCSPACE_SERVER_CORS_MCP_ORIGIN": "*",
                "DOCSPACE_SERVER_CORS_OAUTH_MAX_AGE": "86400000",
                "DOCSPACE_SERVER_CORS_OAUTH_ORIGIN": "*",
                "DOCSPACE_SERVER_RATE_LIMITS_MCP_CAPACITY": "1000",
                "DOCSPACE_SERVER_RATE_LIMITS_MCP_WINDOW": "1000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_WINDOW": "60000",
                "DOCSPACE_SESSION_INTERVAL": "240000",
                "DOCSPACE_SESSION_TTL": "28800000",
                "DOCSPACE_TOOLSETS": "all",
                "DOCSPACE_TRANSPORT": "stdio",
                "DOCSPACE_USER_AGENT": "@onlyoffice/docspace-mcp v3.3.0",
                "DOCSPACE_USERNAME": "<DOCSPACE_USERNAME>"
            }
        }
    }
}

متغيرات البيئة

  • DOCSPACE_API_KEY سري The API key for accessing the API.
  • DOCSPACE_AUTH_TOKEN سري The Personal Access Token (PAT) for accessing the API.
  • DOCSPACE_AUTHORIZATION سري The raw value to include in the Authorization header for API requests.
  • DOCSPACE_BASE_URL The base URL of the ONLYOFFICE Apps instance for API requests.
  • DOCSPACE_DISABLED_TOOLS The list of tools to disable for the MCP server.
  • DOCSPACE_DYNAMIC The flag that indicates whether the MCP server should use meta tools.
  • DOCSPACE_ENABLED_TOOLS The list of tools to enable for the MCP server.
  • DOCSPACE_FILE_OPERATION_INTERVAL The interval for polling the status of in-progress file operations in milliseconds.
  • DOCSPACE_FILE_OPERATION_TIMEOUT The maximum time to wait for a file operation to complete in milliseconds.
  • DOCSPACE_HOST The host to bind the server to.
  • DOCSPACE_OAUTH_AUTH_TOKEN_ALGORITHM The algorithm to use for signing OAuth access tokens.
  • DOCSPACE_OAUTH_AUTH_TOKEN_SECRET_KEY سري The secret key to use for signing OAuth access tokens.
  • DOCSPACE_OAUTH_AUTH_TOKEN_TTL The time-to-live (TTL) for OAuth access tokens in milliseconds.
  • DOCSPACE_OAUTH_BASE_URL The base URL of the ONLYOFFICE Apps OAuth service for OAuth requests.
  • DOCSPACE_OAUTH_CLIENT_ID The client ID of the OAuth application.
  • DOCSPACE_OAUTH_CLIENT_SECRET سري The client secret of the OAuth application.
  • DOCSPACE_OAUTH_STATE_TOKEN_ALGORITHM The algorithm to use for signing OAuth state tokens.
  • DOCSPACE_OAUTH_STATE_TOKEN_SECRET_KEY سري The secret key to use for signing OAuth state tokens.
  • DOCSPACE_OAUTH_STATE_TOKEN_TTL The time-to-live (TTL) for OAuth state tokens in milliseconds.
  • DOCSPACE_PASSWORD سري The password for accessing the API using basic authentication.
  • DOCSPACE_PORT The port to bind the server to.
  • DOCSPACE_PROXY_HOPS The number of proxy servers between the server and the client.
  • DOCSPACE_REQUEST_AUTHORIZATION_HEADER The flag that indicates whether the server should check for the Authorization header in incoming requests.
  • DOCSPACE_REQUEST_HEADER_PREFIX The prefix to use with custom configuration headers.
  • DOCSPACE_REQUEST_QUERY The flag that indicates whether the server should accept configuration via query parameters in incoming requests.
  • DOCSPACE_SERVER_ALLOWED_HOSTNAMES The list of allowed hostnames.
  • DOCSPACE_SERVER_BASE_URL The base URL of the server.
  • DOCSPACE_SERVER_CORS_MCP_MAX_AGE The maximum age in milliseconds to include in the Access-Control-Max-Age header for CORS requests to MCP endpoints.
  • DOCSPACE_SERVER_CORS_MCP_ORIGIN The list of allowed origins to include in the Access-Control-Allow-Origin header for CORS requests to MCP endpoints.
  • DOCSPACE_SERVER_CORS_OAUTH_MAX_AGE The maximum age in milliseconds to include in the Access-Control-Max-Age header for CORS requests to OAuth endpoints.
  • DOCSPACE_SERVER_CORS_OAUTH_ORIGIN The list of allowed origins to include in the Access-Control-Allow-Origin header for CORS requests to OAuth endpoints.
  • DOCSPACE_SERVER_RATE_LIMITS_MCP_CAPACITY The maximum number of requests allowed per window for the MCP endpoints.
  • DOCSPACE_SERVER_RATE_LIMITS_MCP_WINDOW The time window in milliseconds for the rate limit for the MCP endpoints.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_CAPACITY The maximum number of requests allowed per window for the OAuth authorization endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_WINDOW The time window in milliseconds for the rate limit for the OAuth authorization endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_CAPACITY The maximum number of requests allowed per window for the OAuth callback endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_WINDOW The time window in milliseconds for the rate limit for the OAuth callback endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_CAPACITY The maximum number of requests allowed per window for the OAuth introspection endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_WINDOW The time window in milliseconds for the rate limit for the OAuth introspection endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_CAPACITY The maximum number of requests allowed per window for the OAuth client registration endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_WINDOW The time window in milliseconds for the rate limit for the OAuth client registration endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_CAPACITY The maximum number of requests allowed per window for the OAuth resource metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_WINDOW The time window in milliseconds for the rate limit for the OAuth resource metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_CAPACITY The maximum number of requests allowed per window for the OAuth token revocation endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_WINDOW The time window in milliseconds for the rate limit for the OAuth token revocation endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_CAPACITY The maximum number of requests allowed per window for the OAuth server metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_WINDOW The time window in milliseconds for the rate limit for the OAuth server metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_CAPACITY The maximum number of requests allowed per window for the OAuth token endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_WINDOW The time window in milliseconds for the rate limit for the OAuth token endpoint.
  • DOCSPACE_SESSION_INTERVAL The interval for checking HTTP sessions for expiration in milliseconds.
  • DOCSPACE_SESSION_TTL The time-to-live (TTL) for HTTP sessions in milliseconds.
  • DOCSPACE_TOOLSETS The list of toolsets to enable for the MCP server.
  • DOCSPACE_TRANSPORT The transport protocol to use for communication with the MCP server.
  • DOCSPACE_USER_AGENT The user agent to include in the User-Agent header for API requests.
  • DOCSPACE_USERNAME The username for accessing the API using basic authentication.
NPM package @onlyoffice/docspace-mcp
Claude Code 
claude mcp add docspace -e 'DOCSPACE_API_KEY=<your docspace_api_key>' -e 'DOCSPACE_AUTH_TOKEN=<your docspace_auth_token>' -e 'DOCSPACE_AUTHORIZATION=<your docspace_authorization>' -e 'DOCSPACE_BASE_URL=<DOCSPACE_BASE_URL>' -e 'DOCSPACE_DISABLED_TOOLS=<DOCSPACE_DISABLED_TOOLS>' -e 'DOCSPACE_DYNAMIC=false' -e 'DOCSPACE_ENABLED_TOOLS=<DOCSPACE_ENABLED_TOOLS>' -e 'DOCSPACE_FILE_OPERATION_INTERVAL=300' -e 'DOCSPACE_FILE_OPERATION_TIMEOUT=3600000' -e 'DOCSPACE_HOST=127.0.0.1' -e 'DOCSPACE_OAUTH_AUTH_TOKEN_ALGORITHM=HS256' -e 'DOCSPACE_OAUTH_AUTH_TOKEN_SECRET_KEY=<your docspace_oauth_auth_token_secret_key>' -e 'DOCSPACE_OAUTH_AUTH_TOKEN_TTL=3600000' -e 'DOCSPACE_OAUTH_BASE_URL=<DOCSPACE_OAUTH_BASE_URL>' -e 'DOCSPACE_OAUTH_CLIENT_ID=<DOCSPACE_OAUTH_CLIENT_ID>' -e 'DOCSPACE_OAUTH_CLIENT_SECRET=<your docspace_oauth_client_secret>' -e 'DOCSPACE_OAUTH_STATE_TOKEN_ALGORITHM=HS256' -e 'DOCSPACE_OAUTH_STATE_TOKEN_SECRET_KEY=<your docspace_oauth_state_token_secret_key>' -e 'DOCSPACE_OAUTH_STATE_TOKEN_TTL=3600000' -e 'DOCSPACE_PASSWORD=<your docspace_password>' -e 'DOCSPACE_PORT=8080' -e 'DOCSPACE_PROXY_HOPS=0' -e 'DOCSPACE_REQUEST_AUTHORIZATION_HEADER=true' -e 'DOCSPACE_REQUEST_HEADER_PREFIX=X-Mcp-' -e 'DOCSPACE_REQUEST_QUERY=true' -e 'DOCSPACE_SERVER_ALLOWED_HOSTNAMES=localhost,127.0.0.1,[::1]' -e 'DOCSPACE_SERVER_BASE_URL=<DOCSPACE_SERVER_BASE_URL>' -e 'DOCSPACE_SERVER_CORS_MCP_MAX_AGE=86400000' -e 'DOCSPACE_SERVER_CORS_MCP_ORIGIN=*' -e 'DOCSPACE_SERVER_CORS_OAUTH_MAX_AGE=86400000' -e 'DOCSPACE_SERVER_CORS_OAUTH_ORIGIN=*' -e 'DOCSPACE_SERVER_RATE_LIMITS_MCP_CAPACITY=1000' -e 'DOCSPACE_SERVER_RATE_LIMITS_MCP_WINDOW=1000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_WINDOW=60000' -e 'DOCSPACE_SESSION_INTERVAL=240000' -e 'DOCSPACE_SESSION_TTL=28800000' -e 'DOCSPACE_TOOLSETS=all' -e 'DOCSPACE_TRANSPORT=stdio' -e 'DOCSPACE_USER_AGENT=@onlyoffice/docspace-mcp v3.3.0' -e 'DOCSPACE_USERNAME=<DOCSPACE_USERNAME>' -- npx -y @onlyoffice/docspace-mcp@3.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "docspace": {
            "command": "npx",
            "args": [
                "-y",
                "@onlyoffice/docspace-mcp@3.3.0"
            ],
            "env": {
                "DOCSPACE_API_KEY": "<your docspace_api_key>",
                "DOCSPACE_AUTH_TOKEN": "<your docspace_auth_token>",
                "DOCSPACE_AUTHORIZATION": "<your docspace_authorization>",
                "DOCSPACE_BASE_URL": "<DOCSPACE_BASE_URL>",
                "DOCSPACE_DISABLED_TOOLS": "<DOCSPACE_DISABLED_TOOLS>",
                "DOCSPACE_DYNAMIC": "false",
                "DOCSPACE_ENABLED_TOOLS": "<DOCSPACE_ENABLED_TOOLS>",
                "DOCSPACE_FILE_OPERATION_INTERVAL": "300",
                "DOCSPACE_FILE_OPERATION_TIMEOUT": "3600000",
                "DOCSPACE_HOST": "127.0.0.1",
                "DOCSPACE_OAUTH_AUTH_TOKEN_ALGORITHM": "HS256",
                "DOCSPACE_OAUTH_AUTH_TOKEN_SECRET_KEY": "<your docspace_oauth_auth_token_secret_key>",
                "DOCSPACE_OAUTH_AUTH_TOKEN_TTL": "3600000",
                "DOCSPACE_OAUTH_BASE_URL": "<DOCSPACE_OAUTH_BASE_URL>",
                "DOCSPACE_OAUTH_CLIENT_ID": "<DOCSPACE_OAUTH_CLIENT_ID>",
                "DOCSPACE_OAUTH_CLIENT_SECRET": "<your docspace_oauth_client_secret>",
                "DOCSPACE_OAUTH_STATE_TOKEN_ALGORITHM": "HS256",
                "DOCSPACE_OAUTH_STATE_TOKEN_SECRET_KEY": "<your docspace_oauth_state_token_secret_key>",
                "DOCSPACE_OAUTH_STATE_TOKEN_TTL": "3600000",
                "DOCSPACE_PASSWORD": "<your docspace_password>",
                "DOCSPACE_PORT": "8080",
                "DOCSPACE_PROXY_HOPS": "0",
                "DOCSPACE_REQUEST_AUTHORIZATION_HEADER": "true",
                "DOCSPACE_REQUEST_HEADER_PREFIX": "X-Mcp-",
                "DOCSPACE_REQUEST_QUERY": "true",
                "DOCSPACE_SERVER_ALLOWED_HOSTNAMES": "localhost,127.0.0.1,[::1]",
                "DOCSPACE_SERVER_BASE_URL": "<DOCSPACE_SERVER_BASE_URL>",
                "DOCSPACE_SERVER_CORS_MCP_MAX_AGE": "86400000",
                "DOCSPACE_SERVER_CORS_MCP_ORIGIN": "*",
                "DOCSPACE_SERVER_CORS_OAUTH_MAX_AGE": "86400000",
                "DOCSPACE_SERVER_CORS_OAUTH_ORIGIN": "*",
                "DOCSPACE_SERVER_RATE_LIMITS_MCP_CAPACITY": "1000",
                "DOCSPACE_SERVER_RATE_LIMITS_MCP_WINDOW": "1000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_WINDOW": "60000",
                "DOCSPACE_SESSION_INTERVAL": "240000",
                "DOCSPACE_SESSION_TTL": "28800000",
                "DOCSPACE_TOOLSETS": "all",
                "DOCSPACE_TRANSPORT": "stdio",
                "DOCSPACE_USER_AGENT": "@onlyoffice/docspace-mcp v3.3.0",
                "DOCSPACE_USERNAME": "<DOCSPACE_USERNAME>"
            }
        }
    }
}

متغيرات البيئة

  • DOCSPACE_API_KEY سري The API key for accessing the API.
  • DOCSPACE_AUTH_TOKEN سري The Personal Access Token (PAT) for accessing the API.
  • DOCSPACE_AUTHORIZATION سري The raw value to include in the Authorization header for API requests.
  • DOCSPACE_BASE_URL The base URL of the ONLYOFFICE Apps instance for API requests.
  • DOCSPACE_DISABLED_TOOLS The list of tools to disable for the MCP server.
  • DOCSPACE_DYNAMIC The flag that indicates whether the MCP server should use meta tools.
  • DOCSPACE_ENABLED_TOOLS The list of tools to enable for the MCP server.
  • DOCSPACE_FILE_OPERATION_INTERVAL The interval for polling the status of in-progress file operations in milliseconds.
  • DOCSPACE_FILE_OPERATION_TIMEOUT The maximum time to wait for a file operation to complete in milliseconds.
  • DOCSPACE_HOST The host to bind the server to.
  • DOCSPACE_OAUTH_AUTH_TOKEN_ALGORITHM The algorithm to use for signing OAuth access tokens.
  • DOCSPACE_OAUTH_AUTH_TOKEN_SECRET_KEY سري The secret key to use for signing OAuth access tokens.
  • DOCSPACE_OAUTH_AUTH_TOKEN_TTL The time-to-live (TTL) for OAuth access tokens in milliseconds.
  • DOCSPACE_OAUTH_BASE_URL The base URL of the ONLYOFFICE Apps OAuth service for OAuth requests.
  • DOCSPACE_OAUTH_CLIENT_ID The client ID of the OAuth application.
  • DOCSPACE_OAUTH_CLIENT_SECRET سري The client secret of the OAuth application.
  • DOCSPACE_OAUTH_STATE_TOKEN_ALGORITHM The algorithm to use for signing OAuth state tokens.
  • DOCSPACE_OAUTH_STATE_TOKEN_SECRET_KEY سري The secret key to use for signing OAuth state tokens.
  • DOCSPACE_OAUTH_STATE_TOKEN_TTL The time-to-live (TTL) for OAuth state tokens in milliseconds.
  • DOCSPACE_PASSWORD سري The password for accessing the API using basic authentication.
  • DOCSPACE_PORT The port to bind the server to.
  • DOCSPACE_PROXY_HOPS The number of proxy servers between the server and the client.
  • DOCSPACE_REQUEST_AUTHORIZATION_HEADER The flag that indicates whether the server should check for the Authorization header in incoming requests.
  • DOCSPACE_REQUEST_HEADER_PREFIX The prefix to use with custom configuration headers.
  • DOCSPACE_REQUEST_QUERY The flag that indicates whether the server should accept configuration via query parameters in incoming requests.
  • DOCSPACE_SERVER_ALLOWED_HOSTNAMES The list of allowed hostnames.
  • DOCSPACE_SERVER_BASE_URL The base URL of the server.
  • DOCSPACE_SERVER_CORS_MCP_MAX_AGE The maximum age in milliseconds to include in the Access-Control-Max-Age header for CORS requests to MCP endpoints.
  • DOCSPACE_SERVER_CORS_MCP_ORIGIN The list of allowed origins to include in the Access-Control-Allow-Origin header for CORS requests to MCP endpoints.
  • DOCSPACE_SERVER_CORS_OAUTH_MAX_AGE The maximum age in milliseconds to include in the Access-Control-Max-Age header for CORS requests to OAuth endpoints.
  • DOCSPACE_SERVER_CORS_OAUTH_ORIGIN The list of allowed origins to include in the Access-Control-Allow-Origin header for CORS requests to OAuth endpoints.
  • DOCSPACE_SERVER_RATE_LIMITS_MCP_CAPACITY The maximum number of requests allowed per window for the MCP endpoints.
  • DOCSPACE_SERVER_RATE_LIMITS_MCP_WINDOW The time window in milliseconds for the rate limit for the MCP endpoints.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_CAPACITY The maximum number of requests allowed per window for the OAuth authorization endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_WINDOW The time window in milliseconds for the rate limit for the OAuth authorization endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_CAPACITY The maximum number of requests allowed per window for the OAuth callback endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_WINDOW The time window in milliseconds for the rate limit for the OAuth callback endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_CAPACITY The maximum number of requests allowed per window for the OAuth introspection endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_WINDOW The time window in milliseconds for the rate limit for the OAuth introspection endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_CAPACITY The maximum number of requests allowed per window for the OAuth client registration endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_WINDOW The time window in milliseconds for the rate limit for the OAuth client registration endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_CAPACITY The maximum number of requests allowed per window for the OAuth resource metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_WINDOW The time window in milliseconds for the rate limit for the OAuth resource metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_CAPACITY The maximum number of requests allowed per window for the OAuth token revocation endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_WINDOW The time window in milliseconds for the rate limit for the OAuth token revocation endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_CAPACITY The maximum number of requests allowed per window for the OAuth server metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_WINDOW The time window in milliseconds for the rate limit for the OAuth server metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_CAPACITY The maximum number of requests allowed per window for the OAuth token endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_WINDOW The time window in milliseconds for the rate limit for the OAuth token endpoint.
  • DOCSPACE_SESSION_INTERVAL The interval for checking HTTP sessions for expiration in milliseconds.
  • DOCSPACE_SESSION_TTL The time-to-live (TTL) for HTTP sessions in milliseconds.
  • DOCSPACE_TOOLSETS The list of toolsets to enable for the MCP server.
  • DOCSPACE_TRANSPORT The transport protocol to use for communication with the MCP server.
  • DOCSPACE_USER_AGENT The user agent to include in the User-Agent header for API requests.
  • DOCSPACE_USERNAME The username for accessing the API using basic authentication.
OCI package docker.io/onlyoffice/docspace-mcp:3.3.0
Claude Code 
claude mcp add docspace -e 'DOCSPACE_API_KEY=<your docspace_api_key>' -e 'DOCSPACE_AUTH_TOKEN=<your docspace_auth_token>' -e 'DOCSPACE_AUTHORIZATION=<your docspace_authorization>' -e 'DOCSPACE_BASE_URL=<DOCSPACE_BASE_URL>' -e 'DOCSPACE_DISABLED_TOOLS=<DOCSPACE_DISABLED_TOOLS>' -e 'DOCSPACE_DYNAMIC=false' -e 'DOCSPACE_ENABLED_TOOLS=<DOCSPACE_ENABLED_TOOLS>' -e 'DOCSPACE_FILE_OPERATION_INTERVAL=300' -e 'DOCSPACE_FILE_OPERATION_TIMEOUT=3600000' -e 'DOCSPACE_PASSWORD=<your docspace_password>' -e 'DOCSPACE_TOOLSETS=all' -e 'DOCSPACE_TRANSPORT=stdio' -e 'DOCSPACE_USER_AGENT=@onlyoffice/docspace-mcp v3.3.0' -e 'DOCSPACE_USERNAME=<DOCSPACE_USERNAME>' -- docker run -i --rm docker.io/onlyoffice/docspace-mcp:3.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "docspace": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/onlyoffice/docspace-mcp:3.3.0"
            ],
            "env": {
                "DOCSPACE_API_KEY": "<your docspace_api_key>",
                "DOCSPACE_AUTH_TOKEN": "<your docspace_auth_token>",
                "DOCSPACE_AUTHORIZATION": "<your docspace_authorization>",
                "DOCSPACE_BASE_URL": "<DOCSPACE_BASE_URL>",
                "DOCSPACE_DISABLED_TOOLS": "<DOCSPACE_DISABLED_TOOLS>",
                "DOCSPACE_DYNAMIC": "false",
                "DOCSPACE_ENABLED_TOOLS": "<DOCSPACE_ENABLED_TOOLS>",
                "DOCSPACE_FILE_OPERATION_INTERVAL": "300",
                "DOCSPACE_FILE_OPERATION_TIMEOUT": "3600000",
                "DOCSPACE_PASSWORD": "<your docspace_password>",
                "DOCSPACE_TOOLSETS": "all",
                "DOCSPACE_TRANSPORT": "stdio",
                "DOCSPACE_USER_AGENT": "@onlyoffice/docspace-mcp v3.3.0",
                "DOCSPACE_USERNAME": "<DOCSPACE_USERNAME>"
            }
        }
    }
}

متغيرات البيئة

  • DOCSPACE_API_KEY سري The API key for accessing the API.
  • DOCSPACE_AUTH_TOKEN سري The Personal Access Token (PAT) for accessing the API.
  • DOCSPACE_AUTHORIZATION سري The raw value to include in the Authorization header for API requests.
  • DOCSPACE_BASE_URL The base URL of the ONLYOFFICE Apps instance for API requests.
  • DOCSPACE_DISABLED_TOOLS The list of tools to disable for the MCP server.
  • DOCSPACE_DYNAMIC The flag that indicates whether the MCP server should use meta tools.
  • DOCSPACE_ENABLED_TOOLS The list of tools to enable for the MCP server.
  • DOCSPACE_FILE_OPERATION_INTERVAL The interval for polling the status of in-progress file operations in milliseconds.
  • DOCSPACE_FILE_OPERATION_TIMEOUT The maximum time to wait for a file operation to complete in milliseconds.
  • DOCSPACE_PASSWORD سري The password for accessing the API using basic authentication.
  • DOCSPACE_TOOLSETS The list of toolsets to enable for the MCP server.
  • DOCSPACE_TRANSPORT The transport protocol to use for communication with the MCP server.
  • DOCSPACE_USER_AGENT The user agent to include in the User-Agent header for API requests.
  • DOCSPACE_USERNAME The username for accessing the API using basic authentication.
OCI package docker.io/onlyoffice/docspace-mcp:3.3.0
Claude Code 
claude mcp add docspace -e 'DOCSPACE_API_KEY=<your docspace_api_key>' -e 'DOCSPACE_AUTH_TOKEN=<your docspace_auth_token>' -e 'DOCSPACE_AUTHORIZATION=<your docspace_authorization>' -e 'DOCSPACE_BASE_URL=<DOCSPACE_BASE_URL>' -e 'DOCSPACE_DISABLED_TOOLS=<DOCSPACE_DISABLED_TOOLS>' -e 'DOCSPACE_DYNAMIC=false' -e 'DOCSPACE_ENABLED_TOOLS=<DOCSPACE_ENABLED_TOOLS>' -e 'DOCSPACE_FILE_OPERATION_INTERVAL=300' -e 'DOCSPACE_FILE_OPERATION_TIMEOUT=3600000' -e 'DOCSPACE_HOST=127.0.0.1' -e 'DOCSPACE_OAUTH_AUTH_TOKEN_ALGORITHM=HS256' -e 'DOCSPACE_OAUTH_AUTH_TOKEN_SECRET_KEY=<your docspace_oauth_auth_token_secret_key>' -e 'DOCSPACE_OAUTH_AUTH_TOKEN_TTL=3600000' -e 'DOCSPACE_OAUTH_BASE_URL=<DOCSPACE_OAUTH_BASE_URL>' -e 'DOCSPACE_OAUTH_CLIENT_ID=<DOCSPACE_OAUTH_CLIENT_ID>' -e 'DOCSPACE_OAUTH_CLIENT_SECRET=<your docspace_oauth_client_secret>' -e 'DOCSPACE_OAUTH_STATE_TOKEN_ALGORITHM=HS256' -e 'DOCSPACE_OAUTH_STATE_TOKEN_SECRET_KEY=<your docspace_oauth_state_token_secret_key>' -e 'DOCSPACE_OAUTH_STATE_TOKEN_TTL=3600000' -e 'DOCSPACE_PASSWORD=<your docspace_password>' -e 'DOCSPACE_PORT=8080' -e 'DOCSPACE_PROXY_HOPS=0' -e 'DOCSPACE_REQUEST_AUTHORIZATION_HEADER=true' -e 'DOCSPACE_REQUEST_HEADER_PREFIX=X-Mcp-' -e 'DOCSPACE_REQUEST_QUERY=true' -e 'DOCSPACE_SERVER_ALLOWED_HOSTNAMES=localhost,127.0.0.1,[::1]' -e 'DOCSPACE_SERVER_BASE_URL=<DOCSPACE_SERVER_BASE_URL>' -e 'DOCSPACE_SERVER_CORS_MCP_MAX_AGE=86400000' -e 'DOCSPACE_SERVER_CORS_MCP_ORIGIN=*' -e 'DOCSPACE_SERVER_CORS_OAUTH_MAX_AGE=86400000' -e 'DOCSPACE_SERVER_CORS_OAUTH_ORIGIN=*' -e 'DOCSPACE_SERVER_RATE_LIMITS_MCP_CAPACITY=1000' -e 'DOCSPACE_SERVER_RATE_LIMITS_MCP_WINDOW=1000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_WINDOW=60000' -e 'DOCSPACE_SESSION_INTERVAL=240000' -e 'DOCSPACE_SESSION_TTL=28800000' -e 'DOCSPACE_TOOLSETS=all' -e 'DOCSPACE_TRANSPORT=stdio' -e 'DOCSPACE_USER_AGENT=@onlyoffice/docspace-mcp v3.3.0' -e 'DOCSPACE_USERNAME=<DOCSPACE_USERNAME>' -- docker run -i --rm docker.io/onlyoffice/docspace-mcp:3.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "docspace": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/onlyoffice/docspace-mcp:3.3.0"
            ],
            "env": {
                "DOCSPACE_API_KEY": "<your docspace_api_key>",
                "DOCSPACE_AUTH_TOKEN": "<your docspace_auth_token>",
                "DOCSPACE_AUTHORIZATION": "<your docspace_authorization>",
                "DOCSPACE_BASE_URL": "<DOCSPACE_BASE_URL>",
                "DOCSPACE_DISABLED_TOOLS": "<DOCSPACE_DISABLED_TOOLS>",
                "DOCSPACE_DYNAMIC": "false",
                "DOCSPACE_ENABLED_TOOLS": "<DOCSPACE_ENABLED_TOOLS>",
                "DOCSPACE_FILE_OPERATION_INTERVAL": "300",
                "DOCSPACE_FILE_OPERATION_TIMEOUT": "3600000",
                "DOCSPACE_HOST": "127.0.0.1",
                "DOCSPACE_OAUTH_AUTH_TOKEN_ALGORITHM": "HS256",
                "DOCSPACE_OAUTH_AUTH_TOKEN_SECRET_KEY": "<your docspace_oauth_auth_token_secret_key>",
                "DOCSPACE_OAUTH_AUTH_TOKEN_TTL": "3600000",
                "DOCSPACE_OAUTH_BASE_URL": "<DOCSPACE_OAUTH_BASE_URL>",
                "DOCSPACE_OAUTH_CLIENT_ID": "<DOCSPACE_OAUTH_CLIENT_ID>",
                "DOCSPACE_OAUTH_CLIENT_SECRET": "<your docspace_oauth_client_secret>",
                "DOCSPACE_OAUTH_STATE_TOKEN_ALGORITHM": "HS256",
                "DOCSPACE_OAUTH_STATE_TOKEN_SECRET_KEY": "<your docspace_oauth_state_token_secret_key>",
                "DOCSPACE_OAUTH_STATE_TOKEN_TTL": "3600000",
                "DOCSPACE_PASSWORD": "<your docspace_password>",
                "DOCSPACE_PORT": "8080",
                "DOCSPACE_PROXY_HOPS": "0",
                "DOCSPACE_REQUEST_AUTHORIZATION_HEADER": "true",
                "DOCSPACE_REQUEST_HEADER_PREFIX": "X-Mcp-",
                "DOCSPACE_REQUEST_QUERY": "true",
                "DOCSPACE_SERVER_ALLOWED_HOSTNAMES": "localhost,127.0.0.1,[::1]",
                "DOCSPACE_SERVER_BASE_URL": "<DOCSPACE_SERVER_BASE_URL>",
                "DOCSPACE_SERVER_CORS_MCP_MAX_AGE": "86400000",
                "DOCSPACE_SERVER_CORS_MCP_ORIGIN": "*",
                "DOCSPACE_SERVER_CORS_OAUTH_MAX_AGE": "86400000",
                "DOCSPACE_SERVER_CORS_OAUTH_ORIGIN": "*",
                "DOCSPACE_SERVER_RATE_LIMITS_MCP_CAPACITY": "1000",
                "DOCSPACE_SERVER_RATE_LIMITS_MCP_WINDOW": "1000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_WINDOW": "60000",
                "DOCSPACE_SESSION_INTERVAL": "240000",
                "DOCSPACE_SESSION_TTL": "28800000",
                "DOCSPACE_TOOLSETS": "all",
                "DOCSPACE_TRANSPORT": "stdio",
                "DOCSPACE_USER_AGENT": "@onlyoffice/docspace-mcp v3.3.0",
                "DOCSPACE_USERNAME": "<DOCSPACE_USERNAME>"
            }
        }
    }
}

متغيرات البيئة

  • DOCSPACE_API_KEY سري The API key for accessing the API.
  • DOCSPACE_AUTH_TOKEN سري The Personal Access Token (PAT) for accessing the API.
  • DOCSPACE_AUTHORIZATION سري The raw value to include in the Authorization header for API requests.
  • DOCSPACE_BASE_URL The base URL of the ONLYOFFICE Apps instance for API requests.
  • DOCSPACE_DISABLED_TOOLS The list of tools to disable for the MCP server.
  • DOCSPACE_DYNAMIC The flag that indicates whether the MCP server should use meta tools.
  • DOCSPACE_ENABLED_TOOLS The list of tools to enable for the MCP server.
  • DOCSPACE_FILE_OPERATION_INTERVAL The interval for polling the status of in-progress file operations in milliseconds.
  • DOCSPACE_FILE_OPERATION_TIMEOUT The maximum time to wait for a file operation to complete in milliseconds.
  • DOCSPACE_HOST The host to bind the server to.
  • DOCSPACE_OAUTH_AUTH_TOKEN_ALGORITHM The algorithm to use for signing OAuth access tokens.
  • DOCSPACE_OAUTH_AUTH_TOKEN_SECRET_KEY سري The secret key to use for signing OAuth access tokens.
  • DOCSPACE_OAUTH_AUTH_TOKEN_TTL The time-to-live (TTL) for OAuth access tokens in milliseconds.
  • DOCSPACE_OAUTH_BASE_URL The base URL of the ONLYOFFICE Apps OAuth service for OAuth requests.
  • DOCSPACE_OAUTH_CLIENT_ID The client ID of the OAuth application.
  • DOCSPACE_OAUTH_CLIENT_SECRET سري The client secret of the OAuth application.
  • DOCSPACE_OAUTH_STATE_TOKEN_ALGORITHM The algorithm to use for signing OAuth state tokens.
  • DOCSPACE_OAUTH_STATE_TOKEN_SECRET_KEY سري The secret key to use for signing OAuth state tokens.
  • DOCSPACE_OAUTH_STATE_TOKEN_TTL The time-to-live (TTL) for OAuth state tokens in milliseconds.
  • DOCSPACE_PASSWORD سري The password for accessing the API using basic authentication.
  • DOCSPACE_PORT The port to bind the server to.
  • DOCSPACE_PROXY_HOPS The number of proxy servers between the server and the client.
  • DOCSPACE_REQUEST_AUTHORIZATION_HEADER The flag that indicates whether the server should check for the Authorization header in incoming requests.
  • DOCSPACE_REQUEST_HEADER_PREFIX The prefix to use with custom configuration headers.
  • DOCSPACE_REQUEST_QUERY The flag that indicates whether the server should accept configuration via query parameters in incoming requests.
  • DOCSPACE_SERVER_ALLOWED_HOSTNAMES The list of allowed hostnames.
  • DOCSPACE_SERVER_BASE_URL The base URL of the server.
  • DOCSPACE_SERVER_CORS_MCP_MAX_AGE The maximum age in milliseconds to include in the Access-Control-Max-Age header for CORS requests to MCP endpoints.
  • DOCSPACE_SERVER_CORS_MCP_ORIGIN The list of allowed origins to include in the Access-Control-Allow-Origin header for CORS requests to MCP endpoints.
  • DOCSPACE_SERVER_CORS_OAUTH_MAX_AGE The maximum age in milliseconds to include in the Access-Control-Max-Age header for CORS requests to OAuth endpoints.
  • DOCSPACE_SERVER_CORS_OAUTH_ORIGIN The list of allowed origins to include in the Access-Control-Allow-Origin header for CORS requests to OAuth endpoints.
  • DOCSPACE_SERVER_RATE_LIMITS_MCP_CAPACITY The maximum number of requests allowed per window for the MCP endpoints.
  • DOCSPACE_SERVER_RATE_LIMITS_MCP_WINDOW The time window in milliseconds for the rate limit for the MCP endpoints.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_CAPACITY The maximum number of requests allowed per window for the OAuth authorization endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_WINDOW The time window in milliseconds for the rate limit for the OAuth authorization endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_CAPACITY The maximum number of requests allowed per window for the OAuth callback endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_WINDOW The time window in milliseconds for the rate limit for the OAuth callback endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_CAPACITY The maximum number of requests allowed per window for the OAuth introspection endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_WINDOW The time window in milliseconds for the rate limit for the OAuth introspection endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_CAPACITY The maximum number of requests allowed per window for the OAuth client registration endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_WINDOW The time window in milliseconds for the rate limit for the OAuth client registration endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_CAPACITY The maximum number of requests allowed per window for the OAuth resource metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_WINDOW The time window in milliseconds for the rate limit for the OAuth resource metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_CAPACITY The maximum number of requests allowed per window for the OAuth token revocation endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_WINDOW The time window in milliseconds for the rate limit for the OAuth token revocation endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_CAPACITY The maximum number of requests allowed per window for the OAuth server metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_WINDOW The time window in milliseconds for the rate limit for the OAuth server metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_CAPACITY The maximum number of requests allowed per window for the OAuth token endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_WINDOW The time window in milliseconds for the rate limit for the OAuth token endpoint.
  • DOCSPACE_SESSION_INTERVAL The interval for checking HTTP sessions for expiration in milliseconds.
  • DOCSPACE_SESSION_TTL The time-to-live (TTL) for HTTP sessions in milliseconds.
  • DOCSPACE_TOOLSETS The list of toolsets to enable for the MCP server.
  • DOCSPACE_TRANSPORT The transport protocol to use for communication with the MCP server.
  • DOCSPACE_USER_AGENT The user agent to include in the User-Agent header for API requests.
  • DOCSPACE_USERNAME The username for accessing the API using basic authentication.
OCI package docker.io/onlyoffice/docspace-mcp:3.3.0
Claude Code 
claude mcp add docspace -e 'DOCSPACE_API_KEY=<your docspace_api_key>' -e 'DOCSPACE_AUTH_TOKEN=<your docspace_auth_token>' -e 'DOCSPACE_AUTHORIZATION=<your docspace_authorization>' -e 'DOCSPACE_BASE_URL=<DOCSPACE_BASE_URL>' -e 'DOCSPACE_DISABLED_TOOLS=<DOCSPACE_DISABLED_TOOLS>' -e 'DOCSPACE_DYNAMIC=false' -e 'DOCSPACE_ENABLED_TOOLS=<DOCSPACE_ENABLED_TOOLS>' -e 'DOCSPACE_FILE_OPERATION_INTERVAL=300' -e 'DOCSPACE_FILE_OPERATION_TIMEOUT=3600000' -e 'DOCSPACE_HOST=127.0.0.1' -e 'DOCSPACE_OAUTH_AUTH_TOKEN_ALGORITHM=HS256' -e 'DOCSPACE_OAUTH_AUTH_TOKEN_SECRET_KEY=<your docspace_oauth_auth_token_secret_key>' -e 'DOCSPACE_OAUTH_AUTH_TOKEN_TTL=3600000' -e 'DOCSPACE_OAUTH_BASE_URL=<DOCSPACE_OAUTH_BASE_URL>' -e 'DOCSPACE_OAUTH_CLIENT_ID=<DOCSPACE_OAUTH_CLIENT_ID>' -e 'DOCSPACE_OAUTH_CLIENT_SECRET=<your docspace_oauth_client_secret>' -e 'DOCSPACE_OAUTH_STATE_TOKEN_ALGORITHM=HS256' -e 'DOCSPACE_OAUTH_STATE_TOKEN_SECRET_KEY=<your docspace_oauth_state_token_secret_key>' -e 'DOCSPACE_OAUTH_STATE_TOKEN_TTL=3600000' -e 'DOCSPACE_PASSWORD=<your docspace_password>' -e 'DOCSPACE_PORT=8080' -e 'DOCSPACE_PROXY_HOPS=0' -e 'DOCSPACE_REQUEST_AUTHORIZATION_HEADER=true' -e 'DOCSPACE_REQUEST_HEADER_PREFIX=X-Mcp-' -e 'DOCSPACE_REQUEST_QUERY=true' -e 'DOCSPACE_SERVER_ALLOWED_HOSTNAMES=localhost,127.0.0.1,[::1]' -e 'DOCSPACE_SERVER_BASE_URL=<DOCSPACE_SERVER_BASE_URL>' -e 'DOCSPACE_SERVER_CORS_MCP_MAX_AGE=86400000' -e 'DOCSPACE_SERVER_CORS_MCP_ORIGIN=*' -e 'DOCSPACE_SERVER_CORS_OAUTH_MAX_AGE=86400000' -e 'DOCSPACE_SERVER_CORS_OAUTH_ORIGIN=*' -e 'DOCSPACE_SERVER_RATE_LIMITS_MCP_CAPACITY=1000' -e 'DOCSPACE_SERVER_RATE_LIMITS_MCP_WINDOW=1000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_CAPACITY=200' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_WINDOW=60000' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_CAPACITY=10' -e 'DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_WINDOW=60000' -e 'DOCSPACE_SESSION_INTERVAL=240000' -e 'DOCSPACE_SESSION_TTL=28800000' -e 'DOCSPACE_TOOLSETS=all' -e 'DOCSPACE_TRANSPORT=stdio' -e 'DOCSPACE_USER_AGENT=@onlyoffice/docspace-mcp v3.3.0' -e 'DOCSPACE_USERNAME=<DOCSPACE_USERNAME>' -- docker run -i --rm docker.io/onlyoffice/docspace-mcp:3.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "docspace": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/onlyoffice/docspace-mcp:3.3.0"
            ],
            "env": {
                "DOCSPACE_API_KEY": "<your docspace_api_key>",
                "DOCSPACE_AUTH_TOKEN": "<your docspace_auth_token>",
                "DOCSPACE_AUTHORIZATION": "<your docspace_authorization>",
                "DOCSPACE_BASE_URL": "<DOCSPACE_BASE_URL>",
                "DOCSPACE_DISABLED_TOOLS": "<DOCSPACE_DISABLED_TOOLS>",
                "DOCSPACE_DYNAMIC": "false",
                "DOCSPACE_ENABLED_TOOLS": "<DOCSPACE_ENABLED_TOOLS>",
                "DOCSPACE_FILE_OPERATION_INTERVAL": "300",
                "DOCSPACE_FILE_OPERATION_TIMEOUT": "3600000",
                "DOCSPACE_HOST": "127.0.0.1",
                "DOCSPACE_OAUTH_AUTH_TOKEN_ALGORITHM": "HS256",
                "DOCSPACE_OAUTH_AUTH_TOKEN_SECRET_KEY": "<your docspace_oauth_auth_token_secret_key>",
                "DOCSPACE_OAUTH_AUTH_TOKEN_TTL": "3600000",
                "DOCSPACE_OAUTH_BASE_URL": "<DOCSPACE_OAUTH_BASE_URL>",
                "DOCSPACE_OAUTH_CLIENT_ID": "<DOCSPACE_OAUTH_CLIENT_ID>",
                "DOCSPACE_OAUTH_CLIENT_SECRET": "<your docspace_oauth_client_secret>",
                "DOCSPACE_OAUTH_STATE_TOKEN_ALGORITHM": "HS256",
                "DOCSPACE_OAUTH_STATE_TOKEN_SECRET_KEY": "<your docspace_oauth_state_token_secret_key>",
                "DOCSPACE_OAUTH_STATE_TOKEN_TTL": "3600000",
                "DOCSPACE_PASSWORD": "<your docspace_password>",
                "DOCSPACE_PORT": "8080",
                "DOCSPACE_PROXY_HOPS": "0",
                "DOCSPACE_REQUEST_AUTHORIZATION_HEADER": "true",
                "DOCSPACE_REQUEST_HEADER_PREFIX": "X-Mcp-",
                "DOCSPACE_REQUEST_QUERY": "true",
                "DOCSPACE_SERVER_ALLOWED_HOSTNAMES": "localhost,127.0.0.1,[::1]",
                "DOCSPACE_SERVER_BASE_URL": "<DOCSPACE_SERVER_BASE_URL>",
                "DOCSPACE_SERVER_CORS_MCP_MAX_AGE": "86400000",
                "DOCSPACE_SERVER_CORS_MCP_ORIGIN": "*",
                "DOCSPACE_SERVER_CORS_OAUTH_MAX_AGE": "86400000",
                "DOCSPACE_SERVER_CORS_OAUTH_ORIGIN": "*",
                "DOCSPACE_SERVER_RATE_LIMITS_MCP_CAPACITY": "1000",
                "DOCSPACE_SERVER_RATE_LIMITS_MCP_WINDOW": "1000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_CAPACITY": "200",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_WINDOW": "60000",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_CAPACITY": "10",
                "DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_WINDOW": "60000",
                "DOCSPACE_SESSION_INTERVAL": "240000",
                "DOCSPACE_SESSION_TTL": "28800000",
                "DOCSPACE_TOOLSETS": "all",
                "DOCSPACE_TRANSPORT": "stdio",
                "DOCSPACE_USER_AGENT": "@onlyoffice/docspace-mcp v3.3.0",
                "DOCSPACE_USERNAME": "<DOCSPACE_USERNAME>"
            }
        }
    }
}

متغيرات البيئة

  • DOCSPACE_API_KEY سري The API key for accessing the API.
  • DOCSPACE_AUTH_TOKEN سري The Personal Access Token (PAT) for accessing the API.
  • DOCSPACE_AUTHORIZATION سري The raw value to include in the Authorization header for API requests.
  • DOCSPACE_BASE_URL The base URL of the ONLYOFFICE Apps instance for API requests.
  • DOCSPACE_DISABLED_TOOLS The list of tools to disable for the MCP server.
  • DOCSPACE_DYNAMIC The flag that indicates whether the MCP server should use meta tools.
  • DOCSPACE_ENABLED_TOOLS The list of tools to enable for the MCP server.
  • DOCSPACE_FILE_OPERATION_INTERVAL The interval for polling the status of in-progress file operations in milliseconds.
  • DOCSPACE_FILE_OPERATION_TIMEOUT The maximum time to wait for a file operation to complete in milliseconds.
  • DOCSPACE_HOST The host to bind the server to.
  • DOCSPACE_OAUTH_AUTH_TOKEN_ALGORITHM The algorithm to use for signing OAuth access tokens.
  • DOCSPACE_OAUTH_AUTH_TOKEN_SECRET_KEY سري The secret key to use for signing OAuth access tokens.
  • DOCSPACE_OAUTH_AUTH_TOKEN_TTL The time-to-live (TTL) for OAuth access tokens in milliseconds.
  • DOCSPACE_OAUTH_BASE_URL The base URL of the ONLYOFFICE Apps OAuth service for OAuth requests.
  • DOCSPACE_OAUTH_CLIENT_ID The client ID of the OAuth application.
  • DOCSPACE_OAUTH_CLIENT_SECRET سري The client secret of the OAuth application.
  • DOCSPACE_OAUTH_STATE_TOKEN_ALGORITHM The algorithm to use for signing OAuth state tokens.
  • DOCSPACE_OAUTH_STATE_TOKEN_SECRET_KEY سري The secret key to use for signing OAuth state tokens.
  • DOCSPACE_OAUTH_STATE_TOKEN_TTL The time-to-live (TTL) for OAuth state tokens in milliseconds.
  • DOCSPACE_PASSWORD سري The password for accessing the API using basic authentication.
  • DOCSPACE_PORT The port to bind the server to.
  • DOCSPACE_PROXY_HOPS The number of proxy servers between the server and the client.
  • DOCSPACE_REQUEST_AUTHORIZATION_HEADER The flag that indicates whether the server should check for the Authorization header in incoming requests.
  • DOCSPACE_REQUEST_HEADER_PREFIX The prefix to use with custom configuration headers.
  • DOCSPACE_REQUEST_QUERY The flag that indicates whether the server should accept configuration via query parameters in incoming requests.
  • DOCSPACE_SERVER_ALLOWED_HOSTNAMES The list of allowed hostnames.
  • DOCSPACE_SERVER_BASE_URL The base URL of the server.
  • DOCSPACE_SERVER_CORS_MCP_MAX_AGE The maximum age in milliseconds to include in the Access-Control-Max-Age header for CORS requests to MCP endpoints.
  • DOCSPACE_SERVER_CORS_MCP_ORIGIN The list of allowed origins to include in the Access-Control-Allow-Origin header for CORS requests to MCP endpoints.
  • DOCSPACE_SERVER_CORS_OAUTH_MAX_AGE The maximum age in milliseconds to include in the Access-Control-Max-Age header for CORS requests to OAuth endpoints.
  • DOCSPACE_SERVER_CORS_OAUTH_ORIGIN The list of allowed origins to include in the Access-Control-Allow-Origin header for CORS requests to OAuth endpoints.
  • DOCSPACE_SERVER_RATE_LIMITS_MCP_CAPACITY The maximum number of requests allowed per window for the MCP endpoints.
  • DOCSPACE_SERVER_RATE_LIMITS_MCP_WINDOW The time window in milliseconds for the rate limit for the MCP endpoints.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_CAPACITY The maximum number of requests allowed per window for the OAuth authorization endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_AUTHORIZE_WINDOW The time window in milliseconds for the rate limit for the OAuth authorization endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_CAPACITY The maximum number of requests allowed per window for the OAuth callback endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_CALLBACK_WINDOW The time window in milliseconds for the rate limit for the OAuth callback endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_CAPACITY The maximum number of requests allowed per window for the OAuth introspection endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_INTROSPECT_WINDOW The time window in milliseconds for the rate limit for the OAuth introspection endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_CAPACITY The maximum number of requests allowed per window for the OAuth client registration endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REGISTER_WINDOW The time window in milliseconds for the rate limit for the OAuth client registration endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_CAPACITY The maximum number of requests allowed per window for the OAuth resource metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_RESOURCE_METADATA_WINDOW The time window in milliseconds for the rate limit for the OAuth resource metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_CAPACITY The maximum number of requests allowed per window for the OAuth token revocation endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_REVOKE_WINDOW The time window in milliseconds for the rate limit for the OAuth token revocation endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_CAPACITY The maximum number of requests allowed per window for the OAuth server metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_SERVER_METADATA_WINDOW The time window in milliseconds for the rate limit for the OAuth server metadata endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_CAPACITY The maximum number of requests allowed per window for the OAuth token endpoint.
  • DOCSPACE_SERVER_RATE_LIMITS_OAUTH_TOKEN_WINDOW The time window in milliseconds for the rate limit for the OAuth token endpoint.
  • DOCSPACE_SESSION_INTERVAL The interval for checking HTTP sessions for expiration in milliseconds.
  • DOCSPACE_SESSION_TTL The time-to-live (TTL) for HTTP sessions in milliseconds.
  • DOCSPACE_TOOLSETS The list of toolsets to enable for the MCP server.
  • DOCSPACE_TRANSPORT The transport protocol to use for communication with the MCP server.
  • DOCSPACE_USER_AGENT The user agent to include in the User-Agent header for API requests.
  • DOCSPACE_USERNAME The username for accessing the API using basic authentication.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. ONLYOFFICE Apps MCP Server
  2. Features
  3. Use Cases
  4. Connecting Clients to ONLYOFFICE Apps MCP Server
  5. Tools
  6. Documentation
  7. Samples
  8. Privacy Policy
  9. License

ONLYOFFICE Apps MCP Server

[Model Context Protocol] (MCP) is a standardized protocol for managing context between large language models (LLMs) and external systems. This repository provides an MCP server for [ONLYOFFICE Apps].

The ONLYOFFICE Apps MCP Server connects AI tools directly to ONLYOFFICE Apps. This gives AI agents, assistants, and chatbots the ability to manage rooms, collaborate on files, handle permissions, and automate document workflows - all through natural language interactions.

Features

  • Tools with granular control - Access to tools organized into logical toolsets with fine-grained enable/disable capabilities and meta tools.
  • Multiple transport protocols - Support for stdio, SSE, and Streamable HTTP transports.
  • Different authentication methods - Supports API keys, Personal Access Tokens, Basic authentication, and OAuth 2.0 with dynamic client registration. See examples.
  • Request-level configuration - Configure authentication and tool selection during session initialization using custom HTTP headers.
  • Various distribution formats - Available as Docker image, Docker MCP Server, MCP bundle, and Node.js application.

Use Cases

  • Room Management: Create, update, and archive rooms. Configure room types, manage membership, and control access levels.
  • Folder & File Operations: Create folders, upload documents, copy or move items in batches, rename or delete content, and check file or folder details.
  • Collaboration & Permissions: Invite or remove users, adjust security settings, and review current access rights for rooms and shared spaces.
  • Content Access: Retrieve "My documents" or "Rooms" folders, get folder contents, download files as text, and monitor ongoing file operations.
  • People Directory: List all people in the workspace to streamline invitations and access management.

Connecting Clients to ONLYOFFICE Apps MCP Server

You can connect to the ONLYOFFICE Apps MCP server using any MCP clients. We have covered some popular clients, such as Claude Desktop, Cursor, Devin Desktop, etc., and here you can read about it.

Remote ONLYOFFICE Apps MCP Server

The remote ONLYOFFICE Apps MCP Server is hosted by ONLYOFFICE and provides the fastest way to start using ONLYOFFICE Apps tools inside your AI agent. You can connect to it instantly without deploying or configuring anything on your machine.

The public instance is available at https://mcp.onlyoffice.com/mcp for clients that support modern Streamable HTTP transport and at https://mcp.onlyoffice.com/sse for clients that support only the legacy SSE transport. It is preferable to use the Streamable HTTP transport whenever possible.

See all options for connecting clients to the Remote ONLYOFFICE Apps MCP Server here.

Local ONLYOFFICE Apps MCP Server

If your MCP host does not support remote MCP servers, you can run the local version of the ONLYOFFICE Apps MCP Server instead.

Most clients that implement the MCP protocol have a common configuration file in the JSON format, inside which you can add the ONLYOFFICE Apps MCP Local Server.

Note: The common example below is applicable for Docker image, so Docker must be installed on your system.

Step 1. Locate your config file

Find your client .json configuration file.

Step 2. Add the ONLYOFFICE Apps MCP Server entry

Insert the following block into the mcpServers section of your .json configuration file:

{
  "mcpServers": {
    "onlyoffice-apps": {
      "command": "docker",
      "args": [
        "run",
        "--interactive",
        "--rm",
        "--env",
        "DOCSPACE_BASE_URL",
        "--env",
        "DOCSPACE_API_KEY",
        "onlyoffice/docspace-mcp"
      ],
      "env": {
        "DOCSPACE_BASE_URL": "https://your-instance.onlyoffice.com",
        "DOCSPACE_API_KEY": "your-api-key"
      }
    }
  }
}
Step 3. Set environment values
  • DOCSPACE_BASE_URL - the URL of your ONLYOFFICE Apps instance (e.g. https://your-instance.onlyoffice.com).
  • DOCSPACE_API_KEY - your personal API key generated in ONLYOFFICE Apps Developer Tools → API keys (open Developer Tools from the banner at the bottom of the left sidebar).

All available parameters are listed here.

Step 4. Restart the client

Close and reopen your client. In most cases, the ONLYOFFICE Apps MCP Server will start automatically, and you'll be able to issue natural language commands like:

  • Create a new project room and invite Anna with editor rights.
  • Upload this file to "My documents".

Tools

The ONLYOFFICE Apps MCP server implements the Tools concept described in the [MCP specification].

All ONLYOFFICE Apps MCP server tools are described here.

Documentation

The documentation is available in the [docs] directory.

Samples

The following [examples] show how to use ONLYOFFICE Apps MCP server.

Privacy Policy

The policies are available at [Legal Terms] and [Privacy Policy].

License

The ONLYOFFICE Apps MCP server is distributed under the MIT license found in the [LICENSE] file.

[docs]: https://github.com/ONLYOFFICE/docspace-mcp/tree/main/docs [LICENSE]: https://github.com/ONLYOFFICE/docspace-mcp/blob/main/LICENSE

[Model Context Protocol]: https://modelcontextprotocol.io/ [ONLYOFFICE Apps]: https://www.onlyoffice.com/docspace.aspx

[Legal Terms]: https://www.onlyoffice.com/legalterms [Privacy Policy]: https://www.onlyoffice.com/privacy

[MCP specification]: https://modelcontextprotocol.io/specification/2025-11-25/server/tools/

[examples]: https://api.onlyoffice.com/docspace/mcp-server/getting-started/

الأسئلة الشائعة

ما هو io.github.ONLYOFFICE/docspace؟

A room-based collaborative platform

كيف أثبّت io.github.ONLYOFFICE/docspace؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport sse docspace 'https://mcp.onlyoffice.com/sse' --header 'X-Mcp-Api-Key: <The API key for accessing the API.>' --header 'X-Mcp-Auth-Token: <The Personal Access Token (PAT) for accessing the API.>' --header 'X-Mcp-Base-Url: <The base URL of the ONLYOFFICE Apps instance for API requests.>' --header 'X-Mcp-Disabled-Tools: <The list of tools to disable for the MCP server.>' --header 'X-Mcp-Dynamic: <The flag that indicates whether the MCP server should use meta tools.>' --header 'X-Mcp-Enabled-Tools: <The list of tools to enable for the MCP server.>' --header 'X-Mcp-Password: <The password for accessing the API using basic authentication.>' --header 'X-Mcp-Toolsets: <The list of toolsets to enable for the MCP server.>' --header 'X-Mcp-Username: <The username for accessing the API using basic authentication.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ONLYOFFICE/docspace إلى مفتاح API؟

نعم. يتطلب DOCSPACE_API_KEY, DOCSPACE_AUTH_TOKEN, DOCSPACE_AUTHORIZATION, DOCSPACE_PASSWORD, DOCSPACE_OAUTH_AUTH_TOKEN_SECRET_KEY, DOCSPACE_OAUTH_CLIENT_SECRET, DOCSPACE_OAUTH_STATE_TOKEN_SECRET_KEY, X-Mcp-Api-Key, X-Mcp-Auth-Token, X-Mcp-Base-Url, X-Mcp-Disabled-Tools, X-Mcp-Dynamic, X-Mcp-Enabled-Tools, X-Mcp-Password, X-Mcp-Toolsets, X-Mcp-Username، وتضبطها في إعداداته.

هل io.github.ONLYOFFICE/docspace مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.ONLYOFFICE/docspace؟

ينشره ONLYOFFICE. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.