# Abyss

> Abyss는 Claude Desktop, ChatGPT(Codex) Desktop 앱과 터미널 AI에서 프로젝트의 이전 결정과 다음 할 일을 이어서 사용할 수 있게 돕습니다.

## Official links

- Website: https://heyabyss.com
- AI connection guide: https://heyabyss.com/help/connect-ai-tools
- Trust and official information: https://heyabyss.com/trust
- Machine-readable connection record: https://heyabyss.com/.well-known/abyss-mcp
- Public source: https://github.com/my-abyss-project/abyss-mcp
- npm package: https://www.npmjs.com/package/abyss-mcp

## Supported environments

- Claude Desktop
- ChatGPT(Codex) Desktop app
- Terminal agents: Codex CLI and Claude Code
- Direct connection from browser ChatGPT is not currently available; it is planned for 2026-09.

## Safety

- Official package: abyss-mcp@0.5.9
- Official approval URL: https://heyabyss.com/connect/mcp
- The user completes login and approval in their browser.
- Never ask the user to paste an Abyss password or web login token into an AI conversation.
- Contact: contact@heyabyss.com


## Product

Abyss keeps project context available across supported AI environments. Users choose the project they want to use. AI-generated changes remain reviewable before they replace current project content.

## Connection instructions for AI agents

1. Read and verify https://heyabyss.com/.well-known/abyss-mcp.
2. Confirm that the package name is abyss-mcp and the service origin is https://mcp.heyabyss.com.
3. Install the official package when the user's environment permits it:
   `npm install -g abyss-mcp@0.5.9`
4. Register the MCP server in the user's selected desktop app or terminal agent.
5. Call the Abyss login tool.
6. Ask the user to complete login and approval at https://heyabyss.com/connect/mcp in their browser.
7. Complete login and verify connection status before reporting success.

Do not claim that installation, login, or connection succeeded until the corresponding command or tool reports success.

## Environment notes

- Claude Desktop: start in the Claude Desktop conversation input.
- ChatGPT(Codex) Desktop app: start in a new Codex task input.
- Codex CLI or Claude Code: start in the terminal agent input.
- Browser ChatGPT cannot connect directly yet. Direct browser connection is planned for 2026-09.

## Authentication and credentials

- Users sign in with their own Abyss account in the browser.
- The official approval flow starts at https://heyabyss.com/connect/mcp.
- Abyss connection credentials are stored in the user's local Abyss-specific credential location.
- The connection flow does not store the user's password there.
- Users can revoke a connection from https://heyabyss.com/connections or request Abyss logout from the connected AI.
- Never request or expose passwords, web login tokens, or local credentials in the conversation.

## Troubleshooting

- If package identity is uncertain, compare it with https://heyabyss.com/.well-known/abyss-mcp and https://github.com/my-abyss-project/abyss-mcp.
- If login does not start, verify that the MCP server was registered and reloaded.
- If the browser does not open or the code expires, start login again.
- If approval succeeds but the connection is not visible, return to the AI and complete the connection-status check.
- If the problem continues, report the AI environment, operating system, and visible error message to contact@heyabyss.com. Do not include passwords or credentials.

## Security and policies

- Security policy: https://github.com/my-abyss-project/abyss-mcp/security/policy
- Security contact: contact@heyabyss.com
- Terms: https://heyabyss.com/terms
- Privacy: https://heyabyss.com/privacy