> 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. # Yinxiang (China) > Configure the Yinxiang China connector with a Developer Token, NoteStore URL, and Notebook GUID. The Yinxiang China connector uses the official **Developer Token** and NoteStore API. It is read-only, indexes one explicitly selected notebook, and can index note resources as child documents. ## Scope and behavior The connector uses the `app.yinxiang.com` production service, keeps a checkpoint for incremental sync, validates the selected notebook against `listNotebooks`, and filters synchronized notes by that notebook GUID. Treat a Developer Token like a password. Do not commit it to source control or include it in screenshots. Revoke and regenerate it from the Developer Token page if it may have been exposed. ## Prerequisites Create a production token, confirm the target notebook is accessible, and ensure the Alephant deployment can reach the NoteStore URL. ## Step 1: Get a Developer Token Open the [production Developer Token page](https://app.yinxiang.com/api/DeveloperToken.action), create a token, and copy the complete value beginning with `S=`. The official documentation distinguishes production and sandbox token pages. Use matching token, NoteStore URL, and account environments. ## Step 2: Get the NoteStore URL Copy the full URL shown with the token. It normally looks like: ```text https://app.yinxiang.com/shard/{shardId}/notestore ``` ## Step 3: Get the Notebook GUID ### Option A: Read `listNotebooks` ```python token = "" note_store_url = "https://app.yinxiang.com/shard/{shardId}/notestore" for notebook in note_store.listNotebooks(token): print(notebook.name, notebook.guid) ``` ### Option B: Use the returned `guid` Use the target notebook's `guid`, not its name, account ID, or shard ID. ## Step 4: Configure the connector | Field | Value | Check | | ------------------- | ------------------------------ | ------------------------------------------------------- | | Developer Token | Complete token | Same account and environment as the NoteStore URL. | | NoteStore URL | Full URL from the token page | Must end in `/shard/{shardId}/notestore`. | | Notebook GUID | The selected notebook's `guid` | Required and present in `listNotebooks`. | | Include attachments | Optional | Index returned resources as child documents. | | Access scope | Approved Alephant scope | Source permissions do not replace Alephant permissions. | | Connector name | A descriptive name | Do not include the token. | ## Verification checklist 1. Run an indexing attempt and confirm it succeeds. 2. Search a known note title and a keyword from an unselected notebook. 3. If validation fails, re-check the token, NoteStore URL, and GUID as one matching set. 4. If attachments are missing, check the attachment switch and parser support. ## Troubleshooting | Symptom | First check | | ------------------------------------ | ----------------------------------------------------------------------- | | Notebook GUID validation fails | Use `listNotebooks` and copy the exact `guid`. | | Authorized notebook not found | Token, URL, and GUID may belong to different environments or accounts. | | `DATA_CONFLICT` for `notebookFilter` | The connector synchronizes a general chunk and filters by GUID locally. | | Token or URL error | Do not mix sandbox and production values. | | Attachments are missing | Check the attachment switch and parser support. | ## Official references * [Yinxiang Developer documentation](https://dev.yinxiang.com/doc/) * [Developer Tokens](https://dev.yinxiang.com/doc/articles/dev_tokens.php) * [Data model and GUIDs](https://dev.yinxiang.com/doc/articles/data_structure.php) * [NoteStore API reference](https://dev.evernote.com/doc/reference/NoteStore.html) ![Official Developer Token creation page](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/4a391c703afd496f2a67da3e054b05e46911e241e19ab4ea7a49359988232b5b/assets/aivis/yinxiang/developer-token-create.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260825%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260825T002649Z&X-Amz-Expires=604800&X-Amz-Signature=a4ef68ba3d55cd62040ce5e1844c0fe8ed91bf7f1aa20821e8ddaa31fa317f8b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ![Yinxiang China Developer Token and NoteStore URL page with sensitive values redacted](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/40c7f8222b1550bda188c9ed87ed4bfdd1182acc81a5aa64411ea4d3ce9c0216/assets/aivis/yinxiang/user-developer-token-page.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260825%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260825T002649Z&X-Amz-Expires=604800&X-Amz-Signature=f2382a2845ddaf0eb3f80a0e04070eb015b666f2032156663a50ae279cb12cca&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ![Official Developer Token creation result example](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/eb4c01b38610b334a58c7608449d0e7d1413d9faaa50cb7bdec6db3f21aae14b/assets/aivis/yinxiang/developer-token-created.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260825%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260825T002649Z&X-Amz-Expires=604800&X-Amz-Signature=e7078fac0020393c759541c2f5407dd79b8442b0898bbe47aa1fe1f2666c7c41&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ## Related pages * [Connectors & Indexing](/aivis/knowledge/connectors) * [Index Settings](/aivis/knowledge/index-settings) * [Users, Groups & Roles](/aivis/governance/users-and-groups)