# Troubleshooting

## Start with these checks

1. Confirm that sign-in works at [Memside](https://www.memside.com).
2. Refresh the page or restart the connected AI tool.
3. Check the Settings page for the affected feature.
4. Test a simple read or search before testing a change.
5. Record the exact error text and approximate time.

## In-app assistant is not responding

- Open **Settings > LLM Configuration**.
- Confirm the provider details are saved.
- Select **Test**.
- Check the provider account for usage or billing limits.
- Retry after the test succeeds.

## Cannot save a Memory or upload a file

- Check **Settings > Usage & Metrics** for Memory and storage usage.
- Confirm required fields are complete.
- Check the attachment size and file format.

## Cannot find a Memory

- Search for a distinctive word from the title or content.
- Clear Status, Type, Tags, and date filters.
- Check Completed and Archived Memories.
- Secret Memories are unavailable to connected AI tools.
- Confirm the correct Memside account is being used.

## Calendar or text import fails

- Open **Settings > Import & Export**.
- Calendar import requires an `.ics` file.
- **Chat or long text** works with pasted text and supported ChatGPT JSON
  exports.
- CSV import should start with the template on the same page.
- Check required fields and date format before retrying.

## Unauthorized or invalid API key

- Copy the complete key without extra spaces.
- Use `Authorization: Bearer YOUR_KEY`.
- Do not put the key in a URL.
- Confirm the key is active under **Settings > Developer & API**.
- Revoke and replace a key that may have been exposed.

## MCP connects but tools do not appear

- Confirm the client supports remote HTTP MCP.
- Restart the client.
- Enable the Memside server and approve tools when required.
- Check **Settings > AI Permissions** for the Memory and Library MCP controls.
- For command-based setup, confirm Node.js and `npx` are installed.
- Remove duplicate or outdated Memside server entries.

## Library sign-in or logout does not complete

- Open the Library from the main Memside navigation and allow the shared sign-in
  flow to complete.
- Refresh both applications after a recently completed deployment.
- Confirm that cookies are permitted for `memside.com` application hosts.
- Retry sign-out from the page that displays the error.
- Record the exact error text and approximate time if the problem continues.

## Add to Memside is unavailable

- Confirm that the Template is still public.
- Confirm that the Memside and Library sessions use the same account.
- Review account capacity for Memories, Profiles, and other selected items.
- Reopen the Template page and start a new import review.
- A selected AI Skill remains a draft until separate review is completed.

## Template review does not complete

- Reopen the Template review page to load the persistent result.
- **Review needed** or **Review failed** requires attention to the listed
  finding.
- **Review delayed** can be retried without discarding unchanged work.
- File changes must be saved before another review is submitted.

## ChatGPT or Codex MCP installation controls are missing

For the current interface, try either route:

- open **Plugin** from the left bar, then select **Settings > MCP > Install MCP
  server**; or
- open **Profile > Settings > Plugins**, select **Add**, then select **Install
  MCP server**.

In an earlier ChatGPT interface, enable **Developer mode** under **Plugin** or
**Security**, close Settings, open **Plugins** from the left panel, select the
plus button, and choose the custom-plugin option.

Managed workspaces may require administrator approval. Availability can also
vary by account, region, or supported surface. OpenAI may change labels or move
these controls in a future release.

## ChatGPT is connected but unavailable in a chat

- Confirm Memside is available in the Plugin area.
- Start a new chat and enable the plugin if requested.
- Disconnect and reconnect when an earlier OAuth connection has become stale.

## Claude authentication loops

Try adding and authenticating Memside from
[claude.ai](https://claude.ai) first. Then restart Claude desktop or sign in
again.

Confirm the server URL is:

```text
https://api.memside.com/mcp/
```

## Subject or Connection looks out of date

- Refresh the page and reopen the Memory.
- Subject membership and direct Connections are different.
- Archived and Completed Memories can keep confirmed Connections.
- Deleting a Subject removes its links but preserves Memories.
- A suggested Fact is not Current until it is accepted.

## A change or deletion was rejected

The connected AI tool may require approval.

For AI deletion:

1. Enable **AI delete permission** in Settings.
2. Let the AI tool prepare the exact confirmation.
3. Review and approve the specific deletion.

Account deletion and API-key management remain app actions.

## Direct API request fails

- Use `https://api.memside.com` as the base URL.
- Send `Content-Type: application/json` with JSON request bodies.
- Check the HTTP status and response body.
- Avoid automatic retries for create, update, or delete requests unless the
  integration prevents duplicate changes.

## Still not resolved?

Contact [Memside Support](/help/support/) with the app name, operating system,
approximate time, exact error text, and safe reproduction steps.

Remove API keys, tokens, and private information from screenshots or logs.