> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.alephant.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.alephant.io/_mcp/server. # Nutstore & WebDAV > Configure Nutstore or private WebDAV connectors to index files read-only from selected root paths. The Nutstore and WebDAV connector reads files from the official Nutstore WebDAV service or an enterprise private WebDAV deployment. It is read-only: AIvis indexes matching files, but does not upload, modify, move, or delete source files. Use this connector when teams already store shared files in Nutstore or in a compatible WebDAV server and want those files to become searchable by Agents and knowledge search. ## What You Need | Item | Nutstore | Custom WebDAV | | -------------- | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | | WebDAV service | Select `Nutstore`. | Select `Custom WebDAV`. | | Base URL | Use the default `https://dav.jianguoyun.com/dav/`. | Enter the WebDAV endpoint approved by your administrator. | | Username | Use the Nutstore account email address. | Use the WebDAV account name for the target server. | | Password | Use a Nutstore application password from Third-party Application Management. Do not use the Nutstore login password. | Use the password or token issued for the WebDAV account. | | Root paths | Use one or more absolute directories, such as `/` or `/Team/Handbook`. | Use absolute POSIX paths that exist on the WebDAV server. | Nutstore's official WebDAV help describes the same connection triplet: server address, account, and application password. For the official service, the server address is `https://dav.jianguoyun.com/dav/`; the account is the Nutstore login email; the password is the generated third-party application password. ## Generate a Nutstore Application Password For the official Nutstore service, create a dedicated application password before creating the AIvis credential. 1. Sign in to the Nutstore website. 2. Open the account menu, then go to **Account Information** and **Security Options**. 3. In **Third-party Application Management**, choose **Add Application Password**. 4. Enter an application name such as `AIvis` and generate the password. 5. Copy the generated application password and paste it into **Password or App Password** in the AIvis credential form. The Nutstore mobile app also exposes Third-party Application Management from settings. Generate one password per integration where possible, so you can revoke AIvis access without affecting other WebDAV clients. ![Nutstore settings showing Third-party Application Management for WebDAV app passwords](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/706f033f45675365d4664a68b81c2ebb6c4b6032e9429215d8fcc48a8a95a256/assets/aivis/nutstore/nutstore-third-party-settings.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260805%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260805T115549Z&X-Amz-Expires=604800&X-Amz-Signature=7492098dcdd9726c0fe0018f5f6f72269b631d46fe5e203fb9ee8d6fdacb96cc&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ![Nutstore Third-party Application Management page showing the WebDAV server address and a redacted application password](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/170156b7b598f5b4e02a8d105859ecb53a5c3dbc79729a87df405ab6f6927972/assets/aivis/nutstore/nutstore-application-password.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260805%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260805T115549Z&X-Amz-Expires=604800&X-Amz-Signature=5fd4f6e51d8f62f795124eeef9e2397d87a19c831d313ca95c19d6014633c868&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ## Create the Credential | AIvis Field | Recommended Value | Notes | | ------------------------ | -------------------------------------------------- | ------------------------------------------------------------------------------- | | Name | A descriptive name such as `Nutstore - Knowledge`. | This is only shown inside AIvis. | | WebDAV Service | `Nutstore`. | Keeps the official base URL fixed to `https://dav.jianguoyun.com/dav/`. | | WebDAV Base URL | `https://dav.jianguoyun.com/dav/`. | The default is filled automatically for Nutstore. | | Username | Nutstore account email address. | Use the account that can read every folder you plan to index. | | Password or App Password | Nutstore application password. | This is the value generated in Third-party Application Management. | | Allow Private Network | Leave off for official Nutstore. | Enable only for an approved private WebDAV endpoint. | | Allow Insecure HTTP | Leave off for official Nutstore. | HTTP is only allowed when private-network access is explicitly approved. | | Custom CA Certificate | Leave empty for official Nutstore. | Use PEM certificates only for private WebDAV servers with private trust chains. | After saving the credential, use **Test connection** before creating or enabling the connector. ![AIvis Nutstore credential form showing the official WebDAV base URL, username, and app password field](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/252da3e9265a9847625018b28f9b1fcd994cb22f2596cfb46e0350fb8387c454/assets/aivis/nutstore/nutstore-credential-form.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260805%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260805T115549Z&X-Amz-Expires=604800&X-Amz-Signature=3fc958ea838802f11ada1d04dbb78270acc31321af71c370060bdf32348e2398&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ## Configure the Connector | AIvis Field | Requirement | Example | | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | | Connector Name | A human-readable connector name. | `Nutstore Team Docs` | | Root Paths | One or more WebDAV directories to index. Paths must start with `/`, use forward slashes, and cannot contain `..`. | `/`, `/Team/Handbook`, `/Projects/2026/` | | I Understand Object ACL Limitations | Must be checked. | WebDAV file-level ACLs are not synchronized. | | Document Access | Choose who can search documents indexed by this connector. | Use `Private` or group-restricted access for non-public content. | | Maximum File Size | Maximum file size in bytes for indexing. | Keep the default unless your deployment has approved larger documents. | Use narrow root paths whenever possible. Indexing `/` is valid, but it includes every readable folder under the WebDAV account and can produce more content than intended. ![AIvis Nutstore connector form showing root paths, ACL limitation acknowledgement, and document access](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/f223e519f3d3c6f010a77110ce37bd20e7c97a9ee16b6131d88fc0b6529945b7/assets/aivis/nutstore/nutstore-connector-form.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260805%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260805T115549Z&X-Amz-Expires=604800&X-Amz-Signature=c2599698aecdc76e703e5dfcd59f7ec03b43692afcd0027c951347176377d7ec&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ![AIvis connector list showing a scheduled Nutstore connector and indexed document count](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/1e791cb507c46b507114956ce12d49c027fb5ba55e31e04347577b0a55711b35/assets/aivis/nutstore/nutstore-connector-list.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260805%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260805T115549Z&X-Amz-Expires=604800&X-Amz-Signature=a79910b6bb444fb02659a87fdb7f756db509449178d8d501d5e91f2eced155e2&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ## Permissions and ACL Boundary The WebDAV account controls what AIvis can read during indexing. AIvis does not import Nutstore or WebDAV file-level ACLs into document permissions. That means: * Documents under the selected root paths inherit the connector's AIvis access setting. * If different teams should see different folders, create separate connectors with separate root paths and access groups. * Do not make the connector organization-public unless every indexed file is safe for all eligible users in the organization. * If the WebDAV account loses access to a root path, future syncs can fail or stop indexing that path. ## Nutstore Service Limits Nutstore applies WebDAV usage limits. The exact limits can vary by plan or deployment, but the official help currently documents request-frequency limits and a per-request directory item limit. Large folders, frequent syncs, or many parallel connectors can hit those limits. Practical guidance: * Prefer several scoped root paths over one very large root when only a few folders matter. * Avoid scheduling many Nutstore connectors to sync at the same time with the same account. * If a folder contains many files and indexing appears incomplete, split the folder or narrow the root path. * If the connection starts failing after repeated tests or syncs, wait for the WebDAV rate window to reset and then retry. ## Verification After creating the credential and connector: 1. Test the credential connection. 2. Save the connector with the ACL limitation acknowledgement checked. 3. Run an initial sync. 4. Confirm representative files under each root path are indexed. 5. Confirm files outside the root paths are not indexed. 6. Search as an allowed user and verify expected results appear. 7. Search as a user outside the connector audience and verify restricted files do not appear. 8. Rotate the Nutstore application password in a maintenance window and retest the connection. ## Troubleshooting | Symptom | Likely Cause | Resolution | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- | | Authentication failed | The username is not the Nutstore email, or the password is the login password instead of the application password. | Generate a new application password in Nutstore Third-party Application Management and update the AIvis credential. | | Root path not found | The path does not exist, does not start with `/`, contains `..`, or the account cannot read it. | Check the folder path in Nutstore or WebDAV and use an absolute path such as `/Team/Handbook/`. | | Permission denied | The WebDAV account cannot read the selected folder. | Grant the account access in Nutstore or create a connector for a folder it can read. | | TLS or certificate failure | The custom WebDAV endpoint uses an untrusted certificate. | Use HTTPS with a trusted certificate, or provide the approved custom CA PEM for private WebDAV. | | Request blocked by network policy | A private address or insecure HTTP endpoint was configured without explicit approval. | Use the official Nutstore URL, or enable the private-network and HTTP options only for approved internal endpoints. | | Directory listing fails or appears incomplete | Nutstore WebDAV limits or a large directory may be involved. | Narrow the root path, split folders across connectors, reduce sync concurrency, and retry after the rate window resets. | | File is skipped | The file exceeds the connector size threshold or cannot be extracted. | Adjust the maximum file size only after confirming deployment limits and indexing cost. | ## Related Nutstore Documentation * [Nutstore third-party application authorization for WebDAV](https://help.jianguoyun.com/?p=2064) * [Nutstore WebDAV setup example for WPS](https://help.jianguoyun.com/?page_id=290\&paged=9)